Installation

We're working on having packages pre-build for different distributions

Ubuntu (probably other debian derivates too)

    apt install libdata-compare-perl libdata-compare-perl libdirectory-scratch-structured-perl libeval-context-perl libextutils-pkgconfig-perl libfile-homedir-perl libgtk3-perl libio-prompter-perl libterm-size-any-perl libterm-termkey-perl libtest-block-perl libtermkey-dev libmodule-build-perl libsereal-perl libcompress-bzip2-perl libpango-perl libcarp-clan-perl libtest-deep-perl libtest-most-perl libdevel-stacktrace-perl libexception-class-perl libcapture-tiny-perl libtest-differences-perl libmodule-util-perl libtest-nowarnings-perl 

    cpan install Data::TreeDumper::Renderer::GTK App::Asciio

container

Using the instructions above build an asciio image ; the image will be large (~700 MB) as it contains gtk and co.

You can then run the asciio or tasciio like this:

podman run -it --net=host --env="DISPLAY" --volume="$HOME/.Xauthority:/root/.Xauthority:rw" --volume="$HOME:/home/xxx" asciio [asciio|tasciio]

Windows

In the windows environment, you can use asciio through WSL or cygwin.

WSL

The use of WSL is not much different from the Linux environment.However, there are some things that need attention. This link talks about how to connect to the WSL environment and execute GUI programs through remote connections under Windows.

remote_wsl_use_gui_app

Cygwin

  • First install Cygwin.
  • Make sure the following components are installed correctly
    • x11
    • perl
    • Gnome
    • gun-make
    • gcc-g++
  • Search for "gcrypt" in all the packages to be installed, and install all the packages that appear.
  • Install all dependent modules of asciio

Pay attention when installing perl modules, some may be installed through cpan, but some cannot, and can only be installed manually.

When compiling, the Makefile of several modules has an unrecognized option -lnsl. removed it when install it manually.

Start asciio by the following method:

startxwin >/dev/null 2>&1 &
export DISPLAY=:0.0
asciio

Running asciio

$> asciio [file.asciio] # GUI application using Gtk3

$> tasciio [file.asciio] # TUI application

$> asciio_to_text file.asciio # converts asciio files to ASCII

Platforms

Asciio is developed on both Linux and Windows (cygwin).