Skip to content

Releases: doctorfree/Asciiville

Asciiville Version 3.0.2 Release 3

28 Jun 19:35
Compare
Choose a tag to compare

Table of contents

  1. Overview
  2. Installation
    1. Arch Linux based installation
    2. Debian based installation
    3. RPM based installation
    4. Manual installation
  3. Configuration
  4. Usage
  5. Removal
  6. Changelog

Overview

Asciiville provides utilities, tools, applications, games, and scripts to create a rich text-based command line environment enabling the creation of Ascii Art, viewing the included Ascii Art galleries, creating your own custom Ascii Art galleries, and much more. See the Asciiville README for an overview of supported features.

Architecture independent native installation packages are provided for Arch Linux, Debian based Linux systems, and RPM based Linux systems. Compressed tar archives and an installation script are provided for all other platforms.

Asciiville 3.0.2 and later have the option to utilize Homebrew to install packages during ascinit post installation initialization. To use Homebrew, invoke ascinit brew on Linux platforms. Homebrew is the default on Apple macOS.

Installation

Download the latest Arch, Debian, or RPM package format release for your platform. If your platform does not support Arch, Debian, or RPM format installs (e.g. Apple macOS) then download the compressed binary distribution archive for your platform and the Install-bin.sh script.

Installation on macOS must be performed using the manual installation described below.

Arch Linux based installation

Install the package on Arch Linux based systems by executing the command:

sudo pacman -U ./Asciiville_3.0.2-3-any.pkg.tar.zst

Debian based installation

Install the package on Debian based systems by executing the commands:

sudo apt update -y
sudo apt install ./Asciiville_3.0.2-3.deb

Similarly, on a Raspberry Pi:

sudo apt update -y
sudo apt install ./Asciiville_3.0.2-3.deb

RPM based installation

Install the package on RPM based systems by executing the command

sudo dnf update -y
sudo dnf localinstall ./Asciiville-3.0.2-3.rpm

Manual installation

On systems for which the Arch, Debian, or RPM packages will not suffice, install manually either by cloning the repository or by downloading the Install-bin.sh script and the gzip'd distribution archive.

Asciiville can be installed by cloning the repository and executing the Install script:

git clone https://github.com/doctorfree/Asciiville
cd Asciiville
./Install

Alternatively, after downloading the installation script and distribution archive, as a user with sudo privilege execute the commands:

chmod 755 Install-bin.sh
sudo ./Install-bin.sh /path/to/Asciiville_3.0.2-3.<arch>.tgz

For example, to install Asciiville version 3.0.2 release 3 on Apple macOS using the installation script and archive previously downloaded to $HOME/Downloads/:

chmod 755 ~/Downloads/Install-bin.sh
sudo ~/Downloads/Install-bin.sh ~/Downloads/Asciiville_3.0.2-3.Darwin.tgz

After successfully installing Asciiville, as a normal user run the ascinit command to initialize Asciiville. [Note:] Run the ascinit command as the user who will be using asciiville. No sudo is needed, just ascinit.

Configuration

  • REQUIRED: execute the ascinit command to initialize mutt/neomutt, tmux, ranger, and install terminal emulators
    • The ascinit command should be executed as a normal user with sudo privilege
      • ascinit # (not 'sudo ascinit')
    • Execute ascinit -c rather than ascinit if no terminal emulators or graphical utilities are desired

See the Asciiville README for additional configuration info.

Usage

Execute man asciiville to view the asciiville manual page. Explore the features and capabilities of asciiville by running it in interactive menu mode with the command:

asciiville

Asciiville is a suite of character based utilities, art, and animation. As such, it is intended for use in a terminal window from the command line. To view some of the ASCII animation capabilities provided in Asciiville, try the ASCIImatics animations. For example:

asciisplash -a -i

Removal

Removal of the package on Arch Linux based systems can be accomplished by issuing the command:

sudo pacman -Rs asciiville

Removal of the package on Debian based systems can be accomplished by issuing the command:

sudo apt remove asciiville

Removal of the package on RPM based systems can be accomplished by issuing the command:

sudo dnf remove Asciiville

On systems for which the manual installation was performed using the Install-bin.sh script, remove Asciiville manually by downloading the Uninstall-bin.sh script and, as a user with sudo privilege, execute the commands:

chmod 755 Uninstall-bin.sh
sudo ./Uninstall-bin.sh

Note that manual removal of Asciiville using the Uninstall-bin.sh script will not remove any of the dependencies manually installed above. Manual installation and removal of Asciiville is not as robust as packaged installation and removal. Hopefully additional platform packaging will be available in the future. If you would like to assist with this effort, see the 'Contributing' section of the Asciiville README.

Changelog

Asciiville Version 3 adds support for:

  • Automated Neovim installation and configuration
  • Install and use Brew on all platforms
  • Automatic installation of many Ascii games
  • Improved interactive menu system
  • Add a to interactive art view mode to auto zoom
  • Add d to interactive art view mode to set default art font size
  • Add f keyboard control for display of ascii art filename
  • Add zoom_depth and zoom_interval settings in config and ascii art menu
  • Asciiville is now architecture independent
  • Many installation improvements on Apple macOS
  • Move btop to external package install
  • Move cbftp to external package install
  • Move endoh1 to external package install
  • Add term-image command - display and browse images in the terminal
  • Move installation location back to /usr except macOS to /usr/local
  • Improved support for macOS manual installation
  • Moved several package/utility installs from postinstall to ascinit
  • Several bug fixes

See CHANGELOG.md for a full list of changes in every Asciiville release

Asciiville Version 3.0.2 Release 2

27 Jun 21:17
Compare
Choose a tag to compare

Table of contents

  1. Overview
  2. Installation
    1. Arch Linux based installation
    2. Debian based installation
    3. RPM based installation
    4. Manual installation
  3. Configuration
  4. Usage
  5. Removal
  6. Changelog

Overview

Asciiville provides utilities, tools, applications, games, and scripts to create a rich text-based command line environment enabling the creation of Ascii Art, viewing the included Ascii Art galleries, creating your own custom Ascii Art galleries, and much more. See the Asciiville README for an overview of supported features.

Architecture independent native installation packages are provided for Arch Linux, Debian based Linux systems, and RPM based Linux systems. Compressed tar archives and an installation script are provided for all other platforms.

Asciiville 3.0.2 and later have the option to utilize Homebrew to install packages during ascinit post installation initialization. To use Homebrew, invoke ascinit brew on Linux platforms. Homebrew is the default on Apple macOS.

Installation

Download the latest Arch, Debian, or RPM package format release for your platform. If your platform does not support Arch, Debian, or RPM format installs (e.g. Apple macOS) then download the compressed binary distribution archive for your platform and the Install-bin.sh script.

Installation on macOS must be performed using the manual installation described below.

Arch Linux based installation

Install the package on Arch Linux based systems by executing the command:

sudo pacman -U ./Asciiville_3.0.2-2-any.pkg.tar.zst

Debian based installation

Install the package on Debian based systems by executing the commands:

sudo apt update -y
sudo apt install ./Asciiville_3.0.2-2.deb

Similarly, on a Raspberry Pi:

sudo apt update -y
sudo apt install ./Asciiville_3.0.2-2.deb

RPM based installation

Install the package on RPM based systems by executing the command

sudo dnf update -y
sudo dnf localinstall ./Asciiville-3.0.2-2.rpm

Manual installation

On systems for which the Arch, Debian, or RPM packages will not suffice, install manually either by cloning the repository or by downloading the Install-bin.sh script and the gzip'd distribution archive.

Asciiville can be installed by cloning the repository and executing the Install script:

git clone https://github.com/doctorfree/Asciiville
cd Asciiville
./Install

Alternatively, after downloading the installation script and distribution archive, as a user with sudo privilege execute the commands:

chmod 755 Install-bin.sh
sudo ./Install-bin.sh /path/to/Asciiville_3.0.2-2.<arch>.tgz

For example, to install Asciiville version 3.0.2 release 2 on Apple macOS using the installation script and archive previously downloaded to $HOME/Downloads/:

chmod 755 ~/Downloads/Install-bin.sh
sudo ~/Downloads/Install-bin.sh ~/Downloads/Asciiville_3.0.2-2.Darwin.tgz

After successfully installing Asciiville, as a normal user run the ascinit command to initialize Asciiville. [Note:] Run the ascinit command as the user who will be using asciiville. No sudo is needed, just ascinit.

Configuration

  • REQUIRED: execute the ascinit command to initialize mutt/neomutt, tmux, ranger, and install terminal emulators
    • The ascinit command should be executed as a normal user with sudo privilege
      • ascinit # (not 'sudo ascinit')
    • Execute ascinit -c rather than ascinit if no terminal emulators or graphical utilities are desired

See the Asciiville README for additional configuration info.

Usage

Execute man asciiville to view the asciiville manual page. Explore the features and capabilities of asciiville by running it in interactive menu mode with the command:

asciiville

Asciiville is a suite of character based utilities, art, and animation. As such, it is intended for use in a terminal window from the command line. To view some of the ASCII animation capabilities provided in Asciiville, try the ASCIImatics animations. For example:

asciisplash -a -i

Removal

Removal of the package on Arch Linux based systems can be accomplished by issuing the command:

sudo pacman -Rs asciiville

Removal of the package on Debian based systems can be accomplished by issuing the command:

sudo apt remove asciiville

Removal of the package on RPM based systems can be accomplished by issuing the command:

sudo dnf remove Asciiville

On systems for which the manual installation was performed using the Install-bin.sh script, remove Asciiville manually by downloading the Uninstall-bin.sh script and, as a user with sudo privilege, execute the commands:

chmod 755 Uninstall-bin.sh
sudo ./Uninstall-bin.sh

Note that manual removal of Asciiville using the Uninstall-bin.sh script will not remove any of the dependencies manually installed above. Manual installation and removal of Asciiville is not as robust as packaged installation and removal. Hopefully additional platform packaging will be available in the future. If you would like to assist with this effort, see the 'Contributing' section of the Asciiville README.

Changelog

Asciiville Version 3 adds support for:

  • Automated Neovim installation and configuration
  • Install and use Brew on all platforms
  • Automatic installation of many Ascii games
  • Improved interactive menu system
  • Add a to interactive art view mode to auto zoom
  • Add d to interactive art view mode to set default art font size
  • Add f keyboard control for display of ascii art filename
  • Add zoom_depth and zoom_interval settings in config and ascii art menu
  • Asciiville is now architecture independent
  • Many installation improvements on Apple macOS
  • Move btop to external package install
  • Move cbftp to external package install
  • Move endoh1 to external package install
  • Add term-image command - display and browse images in the terminal
  • Move installation location back to /usr except macOS to /usr/local
  • Improved support for macOS manual installation
  • Moved several package/utility installs from postinstall to ascinit
  • Several bug fixes

See CHANGELOG.md for a full list of changes in every Asciiville release

Asciiville Version 3.0.2 Release 1

03 May 21:08
Compare
Choose a tag to compare

Table of contents

  1. Overview
  2. Installation
    1. Arch Linux based installation
    2. Debian based installation
    3. RPM based installation
    4. Manual installation
  3. Configuration
  4. Usage
  5. Removal
  6. Changelog

Overview

Asciiville provides utilities, tools, applications, games, and scripts to create a rich text-based command line environment enabling the creation of Ascii Art, viewing the included Ascii Art galleries, creating your own custom Ascii Art galleries, and much more. See the Asciiville README for an overview of supported features.

Architecture independent native installation packages are provided for Arch Linux, Debian based Linux systems, and RPM based Linux systems. Compressed tar archives and an installation script are provided for all other platforms.

Asciiville 3.0.2 and later have the option to utilize Homebrew to install packages during ascinit post installation initialization. To use Homebrew, invoke ascinit brew on Linux platforms. Homebrew is the default on Apple macOS.

Installation

Download the latest Arch, Debian, or RPM package format release for your platform. If your platform does not support Arch, Debian, or RPM format installs (e.g. Apple macOS) then download the compressed binary distribution archive for your platform and the Install-bin.sh script.

Installation on macOS must be performed using the manual installation described below.

Arch Linux based installation

Install the package on Arch Linux based systems by executing the command:

sudo pacman -U ./Asciiville_3.0.2-1-any.pkg.tar.zst

Debian based installation

Install the package on Debian based systems by executing the commands:

sudo apt update -y
sudo apt install ./Asciiville_3.0.2-1.deb

Similarly, on a Raspberry Pi:

sudo apt update -y
sudo apt install ./Asciiville_3.0.2-1.deb

RPM based installation

Install the package on RPM based systems by executing the command

sudo dnf update -y
sudo dnf localinstall ./Asciiville-3.0.2-1.rpm

Manual installation

On systems for which the Arch, Debian, or RPM packages will not suffice, install manually either by cloning the repository or by downloading the Install-bin.sh script and the gzip'd distribution archive.

Asciiville can be installed by cloning the repository and executing the Install script:

git clone https://github.com/doctorfree/Asciiville
cd Asciiville
./Install

Alternatively, after downloading the installation script and distribution archive, as a user with sudo privilege execute the commands:

chmod 755 Install-bin.sh
sudo ./Install-bin.sh /path/to/Asciiville_3.0.2-1.<arch>.tgz

For example, to install Asciiville version 3.0.2 release 1 on Apple macOS using the installation script and archive previously downloaded to $HOME/Downloads/:

chmod 755 ~/Downloads/Install-bin.sh
sudo ~/Downloads/Install-bin.sh ~/Downloads/Asciiville_3.0.2-1.Darwin.tgz

After successfully installing Asciiville, as a normal user run the ascinit command to initialize Asciiville. [Note:] Run the ascinit command as the user who will be using asciiville. No sudo is needed, just ascinit.

Configuration

  • REQUIRED: execute the ascinit command to initialize mutt/neomutt, tmux, ranger, rainbowstream, and install terminal emulators
    • The ascinit command should be executed as a normal user with sudo privilege
      • ascinit # (not 'sudo ascinit')
    • Execute ascinit -c rather than ascinit if no terminal emulators or graphical utilities are desired
  • OPTIONAL: authorize the command line Twitter client by executing rainbowstream

See the Asciiville README for additional configuration info.

Usage

Execute man asciiville to view the asciiville manual page. Explore the features and capabilities of asciiville by running it in interactive menu mode with the command:

asciiville

Asciiville is a suite of character based utilities, art, and animation. As such, it is intended for use in a terminal window from the command line. To view some of the ASCII animation capabilities provided in Asciiville, try the ASCIImatics animations. For example:

asciisplash -a -i

Removal

Removal of the package on Arch Linux based systems can be accomplished by issuing the command:

sudo pacman -Rs asciiville

Removal of the package on Debian based systems can be accomplished by issuing the command:

sudo apt remove asciiville

Removal of the package on RPM based systems can be accomplished by issuing the command:

sudo dnf remove Asciiville

On systems for which the manual installation was performed using the Install-bin.sh script, remove Asciiville manually by downloading the Uninstall-bin.sh script and, as a user with sudo privilege, execute the commands:

chmod 755 Uninstall-bin.sh
sudo ./Uninstall-bin.sh

Note that manual removal of Asciiville using the Uninstall-bin.sh script will not remove any of the dependencies manually installed above. Manual installation and removal of Asciiville is not as robust as packaged installation and removal. Hopefully additional platform packaging will be available in the future. If you would like to assist with this effort, see the 'Contributing' section of the Asciiville README.

Changelog

Asciiville Version 3 adds support for:

  • Automated Neovim installation and configuration
  • Install and use Brew on all platforms
  • Automatic installation of many Ascii games
  • Improved interactive menu system
  • Add a to interactive art view mode to auto zoom
  • Add d to interactive art view mode to set default art font size
  • Add f keyboard control for display of ascii art filename
  • Add zoom_depth and zoom_interval settings in config and ascii art menu
  • Asciiville is now architecture independent
  • Many installation improvements on Apple macOS
  • Move btop to external package install
  • Move cbftp to external package install
  • Move endoh1 to external package install
  • Add term-image command - display and browse images in the terminal
  • Move installation location back to /usr except macOS to /usr/local
  • Improved support for macOS manual installation
  • Moved several package/utility installs from postinstall to ascinit
  • Several bug fixes

See CHANGELOG.md for a full list of changes in every Asciiville release

Asciiville Version 3.0.1 Release 2

04 Feb 20:51
Compare
Choose a tag to compare

Table of contents

  1. Overview
  2. Installation
    1. Arch Linux based installation
    2. Debian based installation
    3. RPM based installation
    4. Manual installation
  3. Configuration
  4. Usage
  5. Removal
  6. Changelog

Overview

Asciiville provides utilities, tools, applications, games, and scripts to create a rich text-based command line environment enabling the creation of Ascii Art, viewing the included Ascii Art galleries, creating your own custom Ascii Art galleries, and much more. See the Asciiville README for an overview of supported features.

Architecture independent native installation packages are provided for Arch Linux, Debian based Linux systems, and RPM based Linux systems. Compressed tar archives and an installation script are provided for all other platforms.

Installation

Download the latest Arch, Debian, or RPM package format release for your platform. If your platform does not support Arch, Debian, or RPM format installs (e.g. Apple macOS) then download the compressed binary distribution archive for your platform and the Install-bin.sh script.

Installation on macOS must be performed using the manual installation described below.

Arch Linux based installation

Install the package on Arch Linux based systems by executing the command:

sudo pacman -U ./Asciiville_3.0.1-2-any.pkg.tar.zst

Debian based installation

Install the package on Debian based systems by executing the commands:

sudo apt update -y
sudo apt install ./Asciiville_3.0.1-2.deb

Similarly, on a Raspberry Pi:

sudo apt update -y
sudo apt install ./Asciiville_3.0.1-2.deb

RPM based installation

Install the package on RPM based systems by executing the command

sudo dnf update -y
sudo dnf localinstall ./Asciiville-3.0.1-2.rpm

Manual installation

On systems for which the Arch, Debian, or RPM packages will not suffice, install manually either by cloning the repository or by downloading the Install-bin.sh script and the gzip'd distribution archive.

Asciiville can be installed by cloning the repository and executing the Install script:

git clone https://github.com/doctorfree/Asciiville
cd Asciiville
./Install

Alternatively, after downloading the installation script and distribution archive, as a user with sudo privilege execute the commands:

chmod 755 Install-bin.sh
sudo ./Install-bin.sh /path/to/Asciiville_3.0.1-2.<arch>.tgz

For example, to install Asciiville version 3.0.1 release 2 on Apple macOS using the installation script and archive previously downloaded to $HOME/Downloads/:

chmod 755 ~/Downloads/Install-bin.sh
sudo ~/Downloads/Install-bin.sh ~/Downloads/Asciiville_3.0.1-2.Darwin.tgz

After successfully installing Asciiville, as a normal user run the ascinit command to initialize Asciiville. [Note:] Run the ascinit command as the user who will be using asciiville. No sudo is needed, just ascinit.

Configuration

  • REQUIRED: execute the ascinit command to initialize mutt/neomutt, tmux, ranger, rainbowstream, and install terminal emulators
    • The ascinit command should be executed as a normal user with sudo privilege
      • ascinit # (not 'sudo ascinit')
    • Execute ascinit -c rather than ascinit if no terminal emulators or graphical utilities are desired
  • OPTIONAL: authorize the command line Twitter client by executing rainbowstream

See the Asciiville README for additional configuration info.

Usage

Execute man asciiville to view the asciiville manual page. Explore the features and capabilities of asciiville by running it in interactive menu mode with the command:

asciiville

Asciiville is a suite of character based utilities, art, and animation. As such, it is intended for use in a terminal window from the command line. To view some of the ASCII animation capabilities provided in Asciiville, try the ASCIImatics animations. For example:

asciisplash -a -i

Removal

Removal of the package on Arch Linux based systems can be accomplished by issuing the command:

sudo pacman -Rs asciiville

Removal of the package on Debian based systems can be accomplished by issuing the command:

sudo apt remove asciiville

Removal of the package on RPM based systems can be accomplished by issuing the command:

sudo dnf remove Asciiville

On systems for which the manual installation was performed using the Install-bin.sh script, remove Asciiville manually by downloading the Uninstall-bin.sh script and, as a user with sudo privilege, execute the commands:

chmod 755 Uninstall-bin.sh
sudo ./Uninstall-bin.sh

Note that manual removal of Asciiville using the Uninstall-bin.sh script will not remove any of the dependencies manually installed above. Manual installation and removal of Asciiville is not as robust as packaged installation and removal. Hopefully additional platform packaging will be available in the future. If you would like to assist with this effort, see the 'Contributing' section of the Asciiville README.

Changelog

Asciiville Version 3 adds support for:

  • Automatic installation of many Ascii games
  • Improved interactive menu system
  • Add a to interactive art view mode to auto zoom
  • Add d to interactive art view mode to set default art font size
  • Add f keyboard control for display of ascii art filename
  • Add zoom_depth and zoom_interval settings in config and ascii art menu
  • Asciiville is now architecture independent
  • Many installation improvements on Apple macOS
  • Move btop to external package install
  • Move cbftp to external package install
  • Move endoh1 to external package install
  • Add term-image command - display and browse images in the terminal
  • Move installation location back to /usr except macOS to /usr/local
  • Improved support for macOS manual installation
  • Moved several package/utility installs from postinstall to ascinit
  • Several bug fixes

See CHANGELOG.md for a full list of changes in every Asciiville release

Asciiville Version 3.0.1 Release 1

28 Jan 18:26
Compare
Choose a tag to compare

Table of contents

  1. Overview
  2. Installation
    1. Arch Linux based installation
    2. Debian based installation
    3. RPM based installation
    4. Manual installation
  3. Configuration
  4. Usage
  5. Removal
  6. Changelog

Overview

Asciiville version 3.0.1 release 1 adds support for architecture independent installs and includes many bug fixes. Installation on Apple macOS is much improved.

Asciiville version 2.0.1 release 1 added support for Arch-like platforms (e.g. Manjaro Linux), and fixes remote Arch package installations in ascinit.

Asciiville version 2.0.0 release 2 added support for Apple macOS installation, initialization, and use. Installation on macOS must be performed using the manual installation described below.

Supported features include:

  • Featureful ASCII Art display including slideshow and zoom capabilities
  • Character based ASCII Art and image to ascii conversion utility jp2a
  • The lightweight character based system monitor, btop
  • The lightweight character based web browser, w3m
  • The lightweight character based mail client, neomutt
  • The lightweight character based FTP client, cbftp
  • The lightweight character based music player, mpcplus
  • The lightweight character based file manager, ranger
  • The lightweight character based disk usage analyzer, gdu
  • The lightweight character based journal app, jrnl
  • One or more terminal emulators running a command
  • A tmux session
  • A command line web search
  • A zoomable map of the world
  • Command line character based Twitter client
  • A network download/upload speed test
  • The AAlib BB demo running in a tmux session (Debian based systems only)
  • The ASCII text-based dungeon game nethack with Extended ASCII glyphs
  • The cmatrix command that displays the screen from "The Matrix"
  • Display system info
  • Display the Phase of the Moon
  • Display a weather report
  • Display a Pokemon
  • Display the MusicPlayerPlus or RoonCommandLine interactive menus
  • Any character based client the user wishes to run
  • Several asciimatics animations optionally accompanied by audio

Installation

Download the latest Arch, Debian, or RPM package format release for your platform. If your platform does not support Arch, Debian, or RPM format installs (e.g. Apple macOS) then download the compressed binary distribution archive for your platform and the Install-bin.sh script.

Arch Linux based installation

Install the package on Arch Linux based systems by executing the command:

sudo pacman -U ./Asciiville_3.0.1-1-any.pkg.tar.zst

Debian based installation

Install the package on Debian based systems by executing the commands:

sudo apt update -y
sudo apt install ./Asciiville_3.0.1-1.deb

Similarly, on a Raspberry Pi:

sudo apt update -y
sudo apt install ./Asciiville_3.0.1-1.deb

RPM based installation

Install the package on RPM based systems by executing the command

sudo dnf update -y
sudo dnf localinstall ./Asciiville-3.0.1-1.rpm

Manual installation

On systems for which the Arch, Debian, or RPM packages will not suffice, install manually either by cloning the repository or by downloading the Install-bin.sh script and the gzip'd distribution archive.

Asciiville can be installed by cloning the repository and executing the Install script:

git clone https://github.com/doctorfree/Asciiville
cd Asciiville
./Install

Alternatively, after downloading the installation script and distribution archive, as a user with sudo privilege execute the commands:

chmod 755 Install-bin.sh
sudo ./Install-bin.sh /path/to/Asciiville_3.0.1-1.<arch>.tgz

For example, to install Asciiville version 3.0.1 release 1 on Apple macOS using the installation script and archive previously downloaded to $HOME/Downloads/:

chmod 755 ~/Downloads/Install-bin.sh
sudo ~/Downloads/Install-bin.sh ~/Downloads/Asciiville_3.0.1-1.Darwin.tgz

After successfully installing Asciiville, as a normal user run the ascinit command to initialize Asciiville. [Note:] Run the ascinit command as the user who will be using asciiville. No sudo is needed, just ascinit.

Configuration

  • REQUIRED: execute the ascinit command to initialize mutt/neomutt, tmux, ranger, rainbowstream, and install terminal emulators
    • The ascinit command should be executed as a normal user with sudo privilege
      • ascinit # (not 'sudo ascinit')
    • Execute ascinit -c rather than ascinit if no terminal emulators or graphical utilities are desired
  • OPTIONAL: authorize the command line Twitter client by executing rainbowstream

See the Asciiville README for additional configuration info.

Usage

Execute man asciiville to view the asciiville manual page. Explore the features and capabilities of asciiville by running it in interactive menu mode with the command:

asciiville

Asciiville is a suite of character based utilities, art, and animation. As such, it is intended for use in a terminal window from the command line. To view some of the ASCII animation capabilities provided in Asciiville, try the ASCIImatics animations. For example:

asciisplash -a -i

Removal

Removal of the package on Arch Linux based systems can be accomplished by issuing the command:

sudo pacman -Rs asciiville

Removal of the package on Debian based systems can be accomplished by issuing the command:

sudo apt remove asciiville

Removal of the package on RPM based systems can be accomplished by issuing the command:

sudo dnf remove Asciiville

On systems for which the manual installation was performed using the Install-bin.sh script, remove Asciiville manually by downloading the Uninstall-bin.sh script and, as a user with sudo privilege, execute the commands:

chmod 755 Uninstall-bin.sh
sudo ./Uninstall-bin.sh

Note that manual removal of Asciiville using the Uninstall-bin.sh script will not remove any of the dependencies manually installed above. Manual installation and removal of Asciiville is not as robust as packaged installation and removal. Hopefully additional platform packaging will be available in the future. If you would like to assist with this effort, see the 'Contributing' section of the Asciiville README.

Changelog

Version 3.0.1 release 1 adds support for:

  • Architecture independent packaging and installation

Version 2.0.1 release 1 adds support for:

  • Arch-like platforms (e.g. Manjaro Linux)
  • Fixes remote Arch package installations in ascinit

Version 2.0.0 release 2 adds support for:

  • Installation location moved from /usr to /usr/local
  • Apple macOS manual installation
  • Update btop to version 1.2.13

Version 2.0.0 release 1 adds support for:

  • Modularize Asciiville installation and initialization
    • Remove aewan, jp2a, and ninvaders from source, build, and packaging
    • use external build and packaging to install in ascinit
  • Update btop to 1.2.9
  • Install the kitty terminfo entry when installing kitty
  • Add any2ascii command and its dependencies
  • Add asciibrow command
  • Use rich to format usage messages if available
  • Add kitty session startup for zsh users
  • Add Jekyll theme for Github Pages
  • Update tmux configuration
  • Add VHS install in ascinit
  • Improve newsboat config, additional newsboat scripts
  • Use HOME/.config/newsboat for Newsboat config
  • Use kitty for image display in Newsboat
  • Center ascii art when displaying in Kitty

See CHANGELOG.md for a full list of changes in every Asciiville release

Asciiville Version 2.0.1 Release 1

10 Jan 01:19
Compare
Choose a tag to compare

Table of contents

  1. Overview
  2. Installation
    1. Arch Linux based installation
    2. Debian based installation
    3. RPM based installation
    4. Manual installation
  3. Configuration
  4. Usage
  5. Removal
  6. Changelog

Overview

Asciiville version 2.0.1 release 1 adds support for Arch-like platforms (e.g. Manjaro Linux), and fixes remote Arch package installations in ascinit.

Asciiville version 2.0.0 release 2 added support for Apple macOS installation, initialization, and use. Installation on macOS must be performed using the manual installation described below.

[Note:] Version 2.0.0 release 2 and later install all Asciiville components in /usr/local/... rather than /usr/.... It may be necessary to add /usr/local/bin to your shell's PATH environment variable (some effort has been made to do this automatically).

Supported features include:

  • Featureful ASCII Art display including slideshow and zoom capabilities
  • Character based ASCII Art and image to ascii conversion utility jp2a
  • The lightweight character based system monitor, btop
  • The lightweight character based web browser, w3m
  • The lightweight character based mail client, neomutt
  • The lightweight character based FTP client, cbftp
  • The lightweight character based music player, mpcplus
  • The lightweight character based file manager, ranger
  • The lightweight character based disk usage analyzer, gdu
  • The lightweight character based journal app, jrnl
  • One or more terminal emulators running a command
  • A tmux session
  • A command line web search
  • A zoomable map of the world
  • Command line character based Twitter client
  • A network download/upload speed test
  • The AAlib BB demo running in a tmux session (Debian based systems only)
  • The ASCII text-based dungeon game nethack with Extended ASCII glyphs
  • The cmatrix command that displays the screen from "The Matrix"
  • Display system info
  • Display the Phase of the Moon
  • Display a weather report
  • Display a Pokemon
  • Display the MusicPlayerPlus or RoonCommandLine interactive menus
  • Any character based client the user wishes to run
  • Several asciimatics animations optionally accompanied by audio

Installation

Download the latest Arch, Debian, or RPM package format release for your platform. If your platform does not support Arch, Debian, or RPM format installs (e.g. Apple macOS) then download the compressed binary distribution archive for your platform and the Install-bin.sh script.

Arch Linux based installation

Install the package on Arch Linux based systems by executing the command:

sudo pacman -U ./Asciiville_2.0.1-1-x86_64.pkg.tar.zst

Debian based installation

Install the package on Debian based systems by executing the commands:

sudo apt update -y
sudo apt install ./Asciiville_2.0.1-1.amd64.deb

or, on a Raspberry Pi:

sudo apt update -y
sudo apt install ./Asciiville_2.0.1-1.armhf.deb

RPM based installation

Install the package on RPM based systems by executing the command

sudo dnf update -y
sudo dnf localinstall ./Asciiville-2.0.1-1.x86_64.rpm

Manual installation

On systems for which the Arch, Debian, or RPM packages will not suffice, install manually by downloading the Install-bin.sh script and either the gzip'd distribution archive or the zip'd distribution archive. After downloading the installation script and distribution archive, as a user with sudo privilege execute the commands:

chmod 755 Install-bin.sh
sudo ./Install-bin.sh /path/to/Asciiville_2.0.1-1.<arch>.tgz
or
sudo ./Install-bin.sh /path/to/Asciiville_2.0.1-1.<arch>.zip

For example, to install Asciiville version 2.0.1 release 1 on Apple macOS using the installation script and archive previously downloaded to $HOME/Downloads/:

chmod 755 ~/Downloads/Install-bin.sh
sudo ~/Downloads/Install-bin.sh ~/Downloads/Asciiville_2.0.1-1.Darwin.tgz

Configuration

  • REQUIRED: execute the ascinit command to initialize mutt/neomutt, tmux, ranger, rainbowstream, and install terminal emulators
    • The ascinit command should be executed as a normal user with sudo privilege
      • ascinit # (not 'sudo ascinit')
    • Execute ascinit -c rather than ascinit if no terminal emulators or graphical utilities are desired
  • OPTIONAL: authorize the command line Twitter client by executing rainbowstream

See the Asciiville README for additional configuration info.

Usage

Execute man asciiville to view the asciiville manual page. Explore the features and capabilities of asciiville by running it in interactive menu mode with the command:

asciiville

Asciiville is a suite of character based utilities, art, and animation. As such, it is intended for use in a terminal window from the command line. To view some of the ASCII animation capabilities provided in Asciiville, try the ASCIImatics animations. For example:

asciisplash -a -i

Removal

Removal of the package on Arch Linux based systems can be accomplished by issuing the command:

sudo pacman -Rs asciiville

Removal of the package on Debian based systems can be accomplished by issuing the command:

sudo apt remove asciiville

Removal of the package on RPM based systems can be accomplished by issuing the command:

sudo dnf remove Asciiville

On systems for which the manual installation was performed using the Install-bin.sh script, remove Asciiville manually by downloading the Uninstall-bin.sh script and, as a user with sudo privilege, execute the commands:

chmod 755 Uninstall-bin.sh
sudo ./Uninstall-bin.sh

Note that manual removal of Asciiville using the Uninstall-bin.sh script will not remove any of the dependencies manually installed above. Manual installation and removal of Asciiville is not as robust as packaged installation and removal. Hopefully additional platform packaging will be available in the future. If you would like to assist with this effort, see the 'Contributing' section of the Asciiville README.

Changelog

Version 2.0.1 release 1 adds support for:

  • Arch-like platforms (e.g. Manjaro Linux)
  • Fixes remote Arch package installations in ascinit

Version 2.0.0 release 2 adds support for:

  • Installation location moved from /usr to /usr/local
  • Apple macOS manual installation
  • Update btop to version 1.2.13

Version 2.0.0 release 1 adds support for:

  • Modularize Asciiville installation and initialization
    • Remove aewan, jp2a, and ninvaders from source, build, and packaging
    • use external build and packaging to install in ascinit
  • Update btop to 1.2.9
  • Install the kitty terminfo entry when installing kitty
  • Add any2ascii command and its dependencies
  • Add asciibrow command
  • Use rich to format usage messages if available
  • Add kitty session startup for zsh users
  • Add Jekyll theme for Github Pages
  • Update tmux configuration
  • Add VHS install in ascinit
  • Improve newsboat config, additional newsboat scripts
  • Use HOME/.config/newsboat for Newsboat config
  • Use kitty for image display in Newsboat
  • Center ascii art when displaying in Kitty

See CHANGELOG.md for a full list of changes in every Asciiville release

Asciiville Version 2.0.0 Release 2

08 Jan 03:18
Compare
Choose a tag to compare

Table of contents

  1. Overview
  2. Installation
    1. Arch Linux based installation
    2. Debian based installation
    3. RPM based installation
    4. Manual installation
  3. Configuration
  4. Usage
  5. Removal
  6. Changelog

Overview

Asciiville version 2.0.0 release 2 adds support for Apple macOS installation, initialization, and use. Installation on macOS must be performed using the manual installation described below.

[Note:] Version 2.0.0 release 2 and later install all Asciiville components in /usr/local/... rather than /usr/.... It may be necessary to add /usr/local/bin to your shell's PATH environment variable (some effort has been made to do this automatically).

Supported features include:

  • Featureful ASCII Art display including slideshow and zoom capabilities
  • Character based ASCII Art and image to ascii conversion utility jp2a
  • The lightweight character based system monitor, btop
  • The lightweight character based web browser, w3m
  • The lightweight character based mail client, neomutt
  • The lightweight character based FTP client, cbftp
  • The lightweight character based music player, mpcplus
  • The lightweight character based file manager, ranger
  • The lightweight character based disk usage analyzer, gdu
  • The lightweight character based journal app, jrnl
  • One or more terminal emulators running a command
  • A tmux session
  • A command line web search
  • A zoomable map of the world
  • Command line character based Twitter client
  • A network download/upload speed test
  • The AAlib BB demo running in a tmux session (Debian based systems only)
  • The ASCII text-based dungeon game nethack with Extended ASCII glyphs
  • The cmatrix command that displays the screen from "The Matrix"
  • Display system info
  • Display the Phase of the Moon
  • Display a weather report
  • Display a Pokemon
  • Display the MusicPlayerPlus or RoonCommandLine interactive menus
  • Any character based client the user wishes to run
  • Several asciimatics animations optionally accompanied by audio

Installation

Download the latest Arch, Debian, or RPM package format release for your platform. If your platform does not support Arch, Debian, or RPM format installs (e.g. Apple macOS) then download the compressed binary distribution archive for your platform and the Install-bin.sh script.

Arch Linux based installation

Install the package on Arch Linux based systems by executing the command:

sudo pacman -U ./Asciiville_2.0.0-2-x86_64.pkg.tar.zst

Debian based installation

Install the package on Debian based systems by executing the commands:

sudo apt update -y
sudo apt install ./Asciiville_2.0.0-2.amd64.deb

or, on a Raspberry Pi:

sudo apt update -y
sudo apt install ./Asciiville_2.0.0-2.armhf.deb

RPM based installation

Install the package on RPM based systems by executing the command

sudo dnf update -y
sudo dnf localinstall ./Asciiville-2.0.0-2.x86_64.rpm

Manual installation

On systems for which the Arch, Debian, or RPM packages will not suffice, install manually by downloading the Install-bin.sh script and either the gzip'd distribution archive or the zip'd distribution archive. After downloading the installation script and distribution archive, as a user with sudo privilege execute the commands:

chmod 755 Install-bin.sh
sudo ./Install-bin.sh /path/to/Asciiville_2.0.0-2.<arch>.tgz
or
sudo ./Install-bin.sh /path/to/Asciiville_2.0.0-2.<arch>.zip

For example, to install Asciiville version 2.0.0 release 2 on Apple macOS using the installation script and archive previously downloaded to $HOME/Downloads/:

chmod 755 ~/Downloads/Install-bin.sh
sudo ~/Downloads/Install-bin.sh ~/Downloads/Asciiville_2.0.0-2.Darwin.tgz

Configuration

  • REQUIRED: execute the ascinit command to initialize mutt/neomutt, tmux, ranger, rainbowstream, and install terminal emulators
    • The ascinit command should be executed as a normal user with sudo privilege
      • ascinit # (not 'sudo ascinit')
    • Execute ascinit -c rather than ascinit if no terminal emulators or graphical utilities are desired
  • OPTIONAL: authorize the command line Twitter client by executing rainbowstream

See the Asciiville README for additional configuration info.

Usage

Execute man asciiville to view the asciiville manual page. Explore the features and capabilities of asciiville by running it in interactive menu mode with the command:

asciiville

Asciiville is a suite of character based utilities, art, and animation. As such, it is intended for use in a terminal window from the command line. To view some of the ASCII animation capabilities provided in Asciiville, try the ASCIImatics animations. For example:

asciisplash -a -i

Removal

Removal of the package on Arch Linux based systems can be accomplished by issuing the command:

sudo pacman -Rs asciiville

Removal of the package on Debian based systems can be accomplished by issuing the command:

sudo apt remove asciiville

Removal of the package on RPM based systems can be accomplished by issuing the command:

sudo dnf remove Asciiville

On systems for which the manual installation was performed using the Install-bin.sh script, remove Asciiville manually by downloading the Uninstall-bin.sh script and, as a user with sudo privilege, execute the commands:

chmod 755 Uninstall-bin.sh
sudo ./Uninstall-bin.sh

Note that manual removal of Asciiville using the Uninstall-bin.sh script will not remove any of the dependencies manually installed above. Manual installation and removal of Asciiville is not as robust as packaged installation and removal. Hopefully additional platform packaging will be available in the future. If you would like to assist with this effort, see the 'Contributing' section of the Asciiville README.

Changelog

Version 2.0.0 release 2 adds support for:

  • Installation location moved from /usr to /usr/local
  • Apple macOS manual installation
  • Update btop to version 1.2.13

Version 2.0.0 release 1 adds support for:

  • Modularize Asciiville installation and initialization
    • Remove aewan, jp2a, and ninvaders from source, build, and packaging
    • use external build and packaging to install in ascinit
  • Update btop to 1.2.9
  • Install the kitty terminfo entry when installing kitty
  • Add any2ascii command and its dependencies
  • Add asciibrow command
  • Use rich to format usage messages if available
  • Add kitty session startup for zsh users
  • Add Jekyll theme for Github Pages
  • Update tmux configuration
  • Add VHS install in ascinit
  • Improve newsboat config, additional newsboat scripts
  • Use HOME/.config/newsboat for Newsboat config
  • Use kitty for image display in Newsboat
  • Center ascii art when displaying in Kitty

See CHANGELOG.md for a full list of changes in every Asciiville release

Asciiville Version 1.4.1 Release 2

02 Oct 23:53
Compare
Choose a tag to compare

Table of contents

  1. Overview
  2. Installation
    1. Arch Linux based installation
    2. Debian based installation
    3. RPM based installation
    4. Manual installation
  3. Configuration
  4. Usage
  5. Removal
  6. Changelog

Overview

Supported features include:

  • Featureful ASCII Art display including slideshow and zoom capabilities
  • Character based ASCII Art and image to ascii conversion utility jp2a
  • The lightweight character based system monitor, btop
  • The lightweight character based web browser, w3m
  • The lightweight character based mail client, neomutt
  • The lightweight character based FTP client, cbftp
  • The lightweight character based music player, mpcplus
  • The lightweight character based file manager, ranger
  • The lightweight character based disk usage analyzer, gdu
  • The lightweight character based journal app, jrnl
  • One or more terminal emulators running a command
  • A tmux session
  • A command line web search
  • A zoomable map of the world
  • Command line character based Twitter client
  • A network download/upload speed test
  • The AAlib BB demo running in a tmux session (Debian based systems only)
  • The ASCII text-based dungeon game nethack with Extended ASCII glyphs
  • The cmatrix command that displays the screen from "The Matrix"
  • Display system info
  • Display the Phase of the Moon
  • Display a weather report
  • Display a Pokemon
  • Display the MusicPlayerPlus or RoonCommandLine interactive menus
  • Any character based client the user wishes to run
  • Several asciimatics animations optionally accompanied by audio

Installation

Download the latest Arch, Debian, or RPM package format release for your platform.

Arch Linux based installation

Install the package on Arch Linux based systems by executing the command:

sudo pacman -U ./Asciiville_1.4.1-2-x86_64.pkg.tar.zst

Debian based installation

Install the package on Debian based systems by executing the commands:

sudo apt update -y
sudo apt install ./Asciiville_1.4.1-2.amd64.deb

or, on a Raspberry Pi:

sudo apt update -y
sudo apt install ./Asciiville_1.4.1-2.armhf.deb

RPM based installation

Install the package on RPM based systems by executing the command

sudo dnf update -y
sudo dnf localinstall ./Asciiville-1.4.1-2.x86_64.rpm

Manual installation

On systems for which the Arch, Debian, or RPM packages will not suffice, install manually by downloading the Install-bin.sh script and either the gzip'd distribution archive or the zip'd distribution archive. After downloading the installation script and distribution archive, as a user with sudo privilege execute the commands:

chmod 755 Install-bin.sh
sudo ./Install-bin.sh /path/to/Asciiville_1.4.1-2.<arch>.tgz
or
sudo ./Install-bin.sh /path/to/Asciiville_1.4.1-2.<arch>.zip

Configuration

  • REQUIRED: execute the ascinit command to initialize mutt/neomutt, tmux, ranger, rainbowstream, and install terminal emulators
    • The ascinit command should be executed as a normal user with sudo privilege
      • ascinit # (not 'sudo ascinit')
    • Execute ascinit -c rather than ascinit if no terminal emulators or graphical utilities are desired
  • OPTIONAL: authorize the command line Twitter client by executing rainbowstream

See the Asciiville README for additional configuration info.

Usage

Execute man asciiville to view the asciiville manual page. Explore the features and capabilities of asciiville by running it in interactive menu mode with the command:

asciiville

Asciiville is a suite of character based utilities, art, and animation. As such, it is intended for use in a terminal window from the command line. To view some of the ASCII animation capabilities provided in Asciiville, try the ASCIImatics animations. For example:

asciisplash -a -i

Removal

Removal of the package on Arch Linux based systems can be accomplished by issuing the command:

sudo pacman -Rs asciiville

Removal of the package on Debian based systems can be accomplished by issuing the command:

sudo apt remove asciiville

Removal of the package on RPM based systems can be accomplished by issuing the command:

sudo dnf remove Asciiville

On systems for which the manual installation was performed using the Install-bin.sh script, remove Asciiville manually by downloading the Uninstall-bin.sh script and, as a user with sudo privilege, execute the commands:

chmod 755 Uninstall-bin.sh
sudo ./Uninstall-bin.sh

Note that manual removal of Asciiville using the Uninstall-bin.sh script will not remove any of the dependencies manually installed above. Manual installation and removal of Asciiville is not as robust as packaged installation and removal. Hopefully additional platform packaging will be available in the future. If you would like to assist with this effort, see the 'Contributing' section of the Asciiville README.

Changelog

Version 1.4.1 release 2 adds support for:

  • Install go in ascinit if not present
  • Use Kitty as default terminal emulator if available, if not then use gnome-terminal
  • Porting changes to support several modern compiler constraints
  • Integration of asciifetch in asciiville menu
  • Add signal handling and child process wait to asciifetch to enable kitty remote control
  • Add zoom and keepalive to asciifetch
  • Add splash screen to interactive startup
  • Add show_pokemon command
  • Add language and arg processing to weatherfetch, enhance show_weather command
  • Add Pokemon display to commands and menu, enhanced weather report using weatherfetch
  • Patch cbftp if on Arch to accomodate their unified ncurses implementation
  • Use format string to avoid error when -Werror=format-security is enabled
  • Fix aewan build in PKGBUILD
  • Kitty integration, update Kitty configuration, set Kitty url opener in ascinit
  • Add gum install to ascinit
  • Add diyfetch examples to tools/bin
  • Add Sphinx documentation for Asciiville docs on Read the Docs
  • Add installation of rich-cli rich command in ascinit
  • Add color display option to show_endo
  • Add show_endo to display ascii fluid dynamics simulations
  • Add endoh1 fluid dynamics ascii animation and build
  • Add Webb telescope images, add tmux plugin manager

Version 1.4.1 release 1 adds support for:

  • Zoomable display of ascii art
  • Center ascii art in zoom/browse mode
  • Turn linewrap off during ascii art display
  • Add shuffle and length settings to asciiville config
  • Update sample config with character palette settings
  • Upgrade to Btop++ 1.2.7
  • Fix jrnl default config and journals creation
  • Adapt art font size for each file in file list display mode
  • Add support for slideshow of files provided on command line
  • Add support for slideshow/display of files from list in file
  • Add support for centering borderless ascii art
  • Add sample irssi config

Version 1.4.0 added support for:

  • Manual installation and removal for non-Debian/RPM Linux systems
  • Improved Ascii Art display features
  • Additional Ascii Art
  • Shuffle and random display modes now supported
  • Several bug fixes
  • Add aewan ascii art creation tools
  • Add per-gallery config file support
  • Add Vintage ascii art gallery
  • Better support for console-only deployments
  • Console-based mailcap configs used with ascinit -c
  • Add sample NNTP account in NeoMutt (use NeoMutt to read Usenet newsgroups)
  • Use encrypted credentials for NNTP server authenticaton
  • Add preconfigured Cruzio account for NeoMutt
  • Mailcap improvements for mutt, neomutt, and tuir
  • Use jp2a in mailcaps for images
  • Add support for TUIR - Terminal UI for Reddit
  • Add khard contact management integration and configuration
  • Add support for selecting multiple ascii art files with ranger
  • Add ascii art selection to menus
  • View individual ascii art via command line
  • Compress ascii art files
  • Add manual installation script for non Debian/RPM systems
  • Beginning with version 1.4.0 a console-only setup is supported
    • No graphical utilities are installed if ascinit -c used
    • Console screen used exclusively for display
  • Support for xfce4-terminal slideshows with FIFO
  • Updated NetHack to latest development snapshot
  • Add several new Ascii Art galleries
  • Add new text-based games
  • Add termprofset command to manage terminal profile settings
  • Add newsboat RSS Feed reader
  • Maintain Asciiville preferences in $HOME/.config/asciiville/config
  • Move installation of terminal emulators to ascinit
  • Add got translation tool
  • Add tdraw ascii drawing tool
  • Dynamically generate Art folder menu entries
  • Add menu for generating and viewing ascii art
  • User generated ASCII Art galleries can be added to menu

Version 1.3.1 included:

  • W3M configuration with support for acting as a Markdown pager
  • Mailcap and MIME type enhancements for NeoMutt, Mutt, and W3M
  • NeoMutt and Mutt configuration in ascinit
  • Enhanced Mutt/NeoMutt mailcap, auto view text/html MIME type
  • Support for GPG encrypted passwords in NeoMutt
  • Extended Help menu in asciiville
  • Colorized man command output in Help menus
  • Add support and integration for jrnl Journal application
  • Add Matrix and NetHack commands
  • Additional freely licensed songs for slideshow and animation audio tracks
  • Rename all Ascii Art files to use .asc filename suffix
  • Add rifle config for opening .asc files
  • Simplify menus, match partial responses when possible
  • Create and check initialization file in asciiville
  • Add selection menu for command and terminal, add select song option

Asciiville Version 1.4.0 Release 3

31 May 20:34
Compare
Choose a tag to compare

Version 1.4.0 release 3 adds support for:

  • Manual installation and removal for non-Debian/RPM Linux systems
  • Improved Ascii Art display features
  • Additional Ascii Art
  • Shuffle and random display modes now supported
  • Several bug fixes
  • Add aewan ascii art creation tools
  • Add per-gallery config file support
  • Add Vintage ascii art gallery

Version 1.4.0 release 2 added support for:

  • Better support for console-only deployments
  • Console-based mailcap configs used with ascinit -c
  • Add sample NNTP account in NeoMutt (use NeoMutt to read Usenet newsgroups)
  • Use encrypted credentials for NNTP server authenticaton
  • Add preconfigured Cruzio account for NeoMutt
  • Mailcap improvements for mutt, neomutt, and tuir
  • Use jp2a in mailcaps for images
  • Add support for TUIR - Terminal UI for Reddit
  • Add khard contact management integration and configuration
  • Add support for selecting multiple ascii art files with ranger
  • Add ascii art selection to menus
  • View individual ascii art via command line
  • Compress ascii art files

Version 1.4.0 release 1 added support for:

  • Add manual installation script for non Debian/RPM systems
  • Beginning with version 1.4.0 a console-only setup is supported
    • No graphical utilities are installed if ascinit -c used
    • Console screen used exclusively for display
  • Support for xfce4-terminal slideshows with FIFO
  • Updated NetHack to latest development snapshot
  • Add several new Ascii Art galleries
  • Add new text-based games
  • Add termprofset command to manage terminal profile settings
  • Add newsboat RSS Feed reader
  • Maintain Asciiville preferences in $HOME/.config/asciiville/config
  • Move installation of terminal emulators to ascinit
  • Add got translation tool
  • Add tdraw ascii drawing tool
  • Dynamically generate Art folder menu entries
  • Add menu for generating and viewing ascii art
  • User generated ASCII Art galleries can be added to menu

Version 1.3.1 included:

  • W3M configuration with support for acting as a Markdown pager
  • Mailcap and MIME type enhancements for NeoMutt, Mutt, and W3M
  • NeoMutt and Mutt configuration in ascinit
  • Enhanced Mutt/NeoMutt mailcap, auto view text/html MIME type
  • Support for GPG encrypted passwords in NeoMutt
  • Extended Help menu in asciiville
  • Colorized man command output in Help menus
  • Add support and integration for jrnl Journal application
  • Add Matrix and NetHack commands
  • Additional freely licensed songs for slideshow and animation audio tracks
  • Rename all Ascii Art files to use .asc filename suffix
  • Add rifle config for opening .asc files
  • Simplify menus, match partial responses when possible
  • Create and check initialization file in asciiville
  • Add selection menu for command and terminal, add select song option

Supported features include:

  • The lightweight character based system monitor, btop
  • The lightweight character based web browser, w3m
  • The lightweight character based mail client, neomutt
  • The lightweight character based FTP client, cbftp
  • The lightweight character based music player, mpcplus
  • The lightweight character based file manager, ranger
  • The lightweight character based disk usage analyzer, gdu
  • The lightweight character based journal app, jrnl
  • One or more terminal emulators running a command
  • A tmux session
  • A command line web search
  • A zoomable map of the world
  • Command line character based Twitter client
  • A network download/upload speed test
  • The AAlib BB demo running in a tmux session (Debian based systems only)
  • The ASCII text-based dungeon game nethack with Extended ASCII glyphs
  • The cmatrix command that displays the screen from "The Matrix"
  • Character based ASCII Art and image to ascii conversion utility jp2a
  • Display system info
  • Display the Phase of the Moon
  • Display a weather report
  • Display the MusicPlayerPlus or RoonCommandLine interactive menus
  • Any character based client the user wishes to run
  • One of several asciimatics animations optionally accompanied by audio

Installation

Install the package on Debian based systems by executing the commands:

sudo apt update -y
sudo apt install ./Asciiville_1.4.0-3.amd64.deb

or, on a Raspberry Pi:

sudo apt update -y
sudo apt install ./Asciiville_1.4.0-3.armhf.deb

Install the package on RPM based systems by executing the command

sudo dnf update -y
sudo dnf localinstall ./Asciiville-1.4.0-3.x86_64.rpm

On systems for which neither the Debian or RPM packages will suffice,
install manually by downloading the Install-bin.sh script and either
the gzip'd distribution archive or the zip'd distribution archive.
After downloading the installation script and distribution archive,
as a user with sudo privilege execute the commands:

chmod 755 Install-bin.sh
sudo ./Install-bin.sh /path/to/Asciiville_1.4.0-3.<arch>.tgz
or
sudo ./Install-bin.sh /path/to/Asciiville_1.4.0-3.<arch>.zip

Configuration

  • REQUIRED: execute the ascinit command to initialize mutt/neomutt, tmux, ranger, rainbowstream, and install terminal emulators
    • The ascinit command should be executed as a normal user with sudo privilege
      • ascinit # (not 'sudo ascinit')
    • Execute ascinit -c rather than ascinit if no terminal emulators or graphical utilities are desired
  • OPTIONAL: authorize the command line Twitter client by executing rainbowstream

See the Asciiville README for additional configuration info.

Usage

Execute man asciiville to view the asciiville manual page. Explore the features and capabilities of asciiville by running it in interactive menu mode with the command:

asciiville

Asciiville is a suite of character based utilities, art, and animation. As such, it is intended for use in a terminal window from the command line. To view some of the ASCII animation capabilities provided in Asciiville, try the ASCIImatics animations. For example:

asciisplash -a -i

Removal

Removal of the package on Debian based systems can be accomplished by issuing the command:

sudo apt remove asciiville

Removal of the package on RPM based systems can be accomplished by issuing the command:

sudo dnf remove Asciiville

On systems for which the manual installation was performed using
the Install-bin.sh script, remove Asciiville manually by downloading
the Uninstall-bin.sh script and, as a user with sudo privilege,
execute the commands:

chmod 755 Uninstall-bin.sh
sudo ./Uninstall-bin.sh

Note that manual removal of Asciiville using the Uninstall-bin.sh script
will not remove any of the dependencies manually installed above. Manual
installation and removal of Asciiville is not as robust as packaged
installation and removal. Hopefully additional platform packaging will be
available in the future. If you would like to assist with this effort, see the
'Contributing' section of the Asciiville README.

Asciiville Version 1.3.1 Release 2

06 May 20:07
Compare
Choose a tag to compare

This release adds support for:

  • W3M configuration with support for acting as a Markdown pager
  • Mailcap and MIME type enhancements for NeoMutt, Mutt, and W3M
  • NeoMutt and Mutt configuration in ascinit
  • Enhanced Mutt/NeoMutt mailcap, auto view text/html MIME type
  • Support for GPG encrypted passwords in NeoMutt
  • Extended Help menu in asciiville
  • Colorized man command output in Help menus
  • Add support and integration for jrnl Journal application
  • Add Matrix and NetHack commands
  • Additional freely licensed songs for slideshow and animation audio tracks
  • Rename all Ascii Art files to use .asc filename suffix
  • Add rifle config for opening .asc files
  • Simplify menus, match partial responses when possible
  • Create and check initialization file in asciiville
  • Add selection menu for command and terminal, add select song option

Supported features include:

  • The lightweight character based system monitor, btop
  • The lightweight character based web browser, w3m
  • The lightweight character based mail client, neomutt
  • The lightweight character based FTP client, cbftp
  • The lightweight character based music player, mpcplus
  • The lightweight character based file manager, ranger
  • The lightweight character based disk usage analyzer, gdu
  • The lightweight character based journal app, jrnl
  • One or more terminal emulators running a command
  • A tmux session
  • A command line web search
  • A zoomable map of the world
  • Command line character based Twitter client
  • A network download/upload speed test
  • The AAlib BB demo running in a tmux session (Debian based systems only)
  • The ASCII text-based dungeon game nethack with Extended ASCII glyphs
  • The cmatrix command that displays the screen from "The Matrix"
  • Character based ASCII Art and image to ascii conversion utility jp2a
  • Display system info
  • Display the Phase of the Moon
  • Display a weather report
  • Display the MusicPlayerPlus or RoonCommandLine interactive menus
  • Any character based client the user wishes to run
  • One of several asciimatics animations optionally accompanied by audio

Installation

Install the package on Debian based systems by executing the commands:

sudo apt update -y
sudo apt install ./Asciiville_1.3.1-2.amd64.deb

or, on a Raspberry Pi:

sudo apt update -y
sudo apt install ./Asciiville_1.3.1-2.armhf.deb

Install the package on RPM based systems by executing the command

sudo dnf update -y
sudo dnf localinstall ./Asciiville-1.3.1-2.x86_64.rpm

Configuration

  • REQUIRED: execute the ascinit command to initialize mutt/neomutt, tmux, ranger, and rainbowstream
  • OPTIONAL: authorize the command line Twitter client by executing rainbowstream

See the Asciiville README for additional configuration info.

Usage

Execute man asciiville to view the asciiville manual page. Explore the features and capabilities of asciiville by running it in interactive menu mode with the command asciiville -i.

Asciiville is a suite of character based utilities, art, and animation. As such, it is intended for use in a terminal window from the command line. To view some of the ASCII animation capabilities provided in Asciiville, try the ASCIImatics animations. For example:

asciisplash -a -i

Removal

Removal of the package on Debian based systems can be accomplished by issuing the command:

sudo apt remove asciiville

Removal of the package on RPM based systems can be accomplished by issuing the command:

sudo dnf remove Asciiville