Ascinit man page
NAME
ascinit - Asciiville initialization script
SYNOPSIS
ascinit [-a] [-c] [-d] [-m] [-M] [-n] [-N] [-q] [-r] [-t] [-y] [-u] [arg]
DESCRIPTION
The ascinit command should be run as a normal user with sudo
privilege
after installing Asciiville. It performs several configuration initializations
for the user. These include:
The Kitty terminal emulator is installed and configured
The Neovim text editor is installed and configured
Mutt and/or NeoMutt startup files are customized
Tmux configuration is created
default Ranger and Rifle configuration files are created
Asciimatics and Rainbowstream installation is performed
Optionally authorizing the Rainbow Stream app with Twitter
Optionally additional terminal emulators can be installed and configured
Asciiville profiles in Gnome and Tilix terminals are created, if installed
Although command line options are provided to control the action(s) of the
ascinit
command (see below), the typical invocation will simply be ascinit
with no options. This default invocation performs a NeoMutt configuration,
does not configure Mutt, configures Tmux and Ranger and Rifle, installs
Asciimatics and Rainbowstream if not already installed, does not authorize
Rainbow Stream with Twitter, installs the Kitty terminal emulator, installs
the Neovim text editor, installs ASCII games, and creates an Asciiville profile
in gnome-terminal and tilix if installed.
If initialization is being performed on a headless system or a system
without graphical capabilities then execute the command ascinit -c
rather than ascinit
. When invoked with the -c
option the ascinit
command will not install the terminal emulators or create the terminal profiles.
A minimal initialization can be performed with the command:
ascinit minimal
The “minimal” Asciiville initialization does not install optional components
like NeoMutt
, Neovim
, Ascii games, cbftp
, and aewan
. These components
can be installed subsequently by rerunning ascinit
without arguments.
An initialization can be performed using Homebrew rather than the native package manager with the command:
ascinit brew
In addition to initialization of Asciiville components, ascinit
can be used
to individually install and remove the ASCII games, Kitty terminal emulator,
and Neovim text editor. To install one of these components, issue the command:
ascinit <component>
where component is one of games, kitty, or neovim. To remove one of these componenents, run:
ascinit -r <component>
COMMAND LINE OPTIONS
-a : indicates ask to play an animation when done
-c : indicates console-only mode, no terminal emulators are installed or configured and several mailcap configurations specifically tailored for console use are installed
-d : indicates debug mode
-m : indicates setup user Mutt configuration
-M : indicates setup both Mutt and NeoMutt configurations
-n : indicates setup user NeoMutt configuration
-N : indicates prompt for installation of additional terminal emulators
-q : indicates quiet mode, messages are suppressed. In quiet mode initialization all Asciiville components are installed.
-r : indicates remove service/package
-t : indicates authorize the Rainbow Stream app at Twitter
-y : indicates answer yes to all prompts except tmux configuration
-u : indicates display this usage message and exit
LICENSING
ASCINIT is distributed under an Open Source license. See the file LICENSE in the ASCINIT source distribution for information on terms & conditions for accessing and otherwise using ASCINIT and for a DISCLAIMER OF ALL WARRANTIES.
BUGS
Submit bug reports online at:
SEE ALSO
asciiart(1), asciimpplus(1), asciiplasma(1), asciisplash(1), asciisplash-tmux(1), asciiville(1)
Full documentation and sources at: