Installation

Asciiville 3.0.1 and later can be installed on any architecture. Asciiville 3.0.2 and later can optionally utilize Homebrew to install packages during ascinit post installation initialization.

Asciiville can be installed on Linux systems using the Arch Linux packaging format, the Debian packaging format, the Red Hat Package Manager (RPM), or manually with the Linux compressed tar archive. Asciiville can be installed on Apple macOS using the Darwin compressed tar archive.

Currently tested platforms include Apple macOS, Arch Linux, Ubuntu Linux, Fedora Linux, and Raspbian Linux.

Installation packages are provided in Debian packaging format, Red Hat package manager (RPM) format, and Arch Linux packaging format.

See the Build section below to compile and build a package on an Linux platform other than those for which packages are provided.

Arch Linux package installation

The pacman package manager is one of the major distinguishing features of Arch Linux. It combines a simple binary package format with an easy-to-use build system. The goal of pacman is to make it possible to easily manage packages, whether they are from the official repositories or the user’s own builds.

To install on an Arch based Linux system, download the latest Arch format package from the Asciiville Releases.

Install the Asciiville package by executing the command

sudo pacman -U ./Asciiville_<version>-<release>-any.pkg.tar.zst

Debian package installation

Many Linux distributions, most notably Ubuntu and its derivatives, use the Debian packaging system.

To tell if a Linux system is Debian based it is usually sufficient to check for the existence of the file /etc/debian_version and/or examine the contents of the file /etc/os-release.

To install on a Debian based Linux system, download the latest Debian format package from the Asciiville Releases.

Install the Asciiville package by executing the command

sudo apt install ./Asciiville_<version>-<release>.deb

or

sudo dpkg -i ./Asciiville_<version>-<release>.deb

Similarly, on a Raspberry Pi:

sudo apt install ./Asciiville_<version>-<release>.deb

or

sudo dpkg -i ./Asciiville_<version>-<release>.deb

RPM package installation

Red Hat Linux, SUSE Linux, and their derivatives use the RPM packaging format. RPM based Linux distributions include Fedora, AlmaLinux, CentOS, openSUSE, OpenMandriva, Mandrake Linux, Red Hat Linux, and Oracle Linux.

To install on an RPM based Linux system, download the latest RPM format package from the Asciiville Releases.

Install the Asciiville package by executing the command

sudo dnf localinstall ./Asciiville_<version>-<release>.rpm

or

sudo yum localinstall ./Asciiville_<version>-<release>.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 for your platform.

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_<version>-<release>.<arch>.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.

BB AAlib Demo

The BB AAlib Demo is not included in some distributions’ default RPM repositories. Because of that, it is not included as a dependency in RPM installs. However, the asciiville command will utilize the BB Demo if it is installed. To activate this feature it may be necessary to manually install the bb package. This may entail enabling a third-party repository. For example, on Fedora Linux, to install bb:

  • Add RPM Fusion repositories to your system

  • Download latest rpmsphere-release rpm from

    • https://github.com/rpmsphere/noarch/tree/master/r

  • Install rpmsphere-release rpm:

    • sudo rpm -Uvh rpmsphere-release*rpm

  • Install bb rpm package:

    • sudo dnf install bb

The BB AAlib Demo is not required. It’s just a fun demo.