jq-tput-terminal (Xterm CLI Rosary)

by mezcel 5 years ago

GNU/Linux ◆ xterm-256color ◆ bash 1469 views

jq-tput-terminal

A Scripture Rosary GUI on the Bash CLI. github

Liturgical Calendar (Paschal Full Moon) with Seasonal and Feast Day triggered events.
Vulgate Latin and NAB English Biblical translation database
Daily Mass Readings (scraped from usccb.org)
Prayer Chant Soundtrack ( Ogg Audio provided by wikimedia.org / archive.org )

About:

This is a Linux CLI terminal GUI App.

This App was built arround a slimmed down json database which was ported from electron-container.

Recommended Use Cases:

“Busy Persons Retreat” and or Leccio Divina
Run locally in a background terminal session for audio room ambiance. Interactive Jukebox
Host on a ssh/ssl network.
For use as an educational quick reference (Catechism, linguistic, terminal cli, cultural history)

Requirement Dependencies:

Basic GNU Terminal Tools: Bash, ncurses/tput, wget, cal, bc, awk, & grep
JQ is a cross-platform C program which parses json script via command line terminal
dialog / whiptail is a terminal App for making dialog box style input prompts
ogg123 is a ogg audio player which can run within terminal environment
elinks is a well-established feature-rich text mode web (HTTP/FTP/..) browser.

Run

This App will perform a requirements check and install Audio & Software, as needed, on startup. When possible, it will render in Xterm at 140x40. Your alsa or pulseaudio must already be configured on your system for audio to work.

(Main) CLI App: ./bash-rosary

App Launcher for Desktop Environment: ./xterm-launcher (it will call ./bash-rosary)
Automatically verify and add needed software that is missing on your system. ./source/gnu/download-gnu-software (Called automatically from within App or you can run it manually)

Test Environments:

Test Distro’s	Development Environment Notes
Arch	This App was developed on Arch Linux. I also tested it with shellinabox cross platform hosting.
Slackware	Tested on Salix ( legacy repo linux platform compatible )
Alpine	OpenRC, Docker, BusyBox. Fastest install and setup process
Ubuntu	Trisquel, Tahrpup, and Mint. Average performance.
Debian	Jq/gcc performed the best on Debian resulting in fast query processing
WSL	All the GNU works, but other than testing, I did dot build it for WLS

More by mezcel

printf-time (v0.3.5 update) 02:33

by mezcel 5 years ago

printf-time 01:12

by mezcel 5 years ago

python-curses (quick demo) 00:59

by mezcel 4 years ago

struct-fmt (tui demo) 00:56

by mezcel 4 years ago

See all

You can download this recording in asciicast v2 format, as a .cast file.

Download

Replay in terminal

You can replay the downloaded recording in your terminal using the asciinema play command:

asciinema play 243201.cast

If you don't have asciinema CLI installed then see installation instructions.

Use with stand-alone player on your website

Download asciinema player from the releases page (you only need .js and .css file), then use it like this:

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" type="text/css" href="asciinema-player.css" />
</head>
<body>
  <div id="player"></div>
  <script src="asciinema-player.min.js"></script>
  <script>
    AsciinemaPlayer.create(
      '/assets/243201.cast',
      document.getElementById('player'),
      { cols: 140, rows: 40 }
    );
  </script>
</body>
</html>

See asciinema player quick-start guide for full usage instructions.

While this site doesn't provide GIF conversion at the moment, you can still do it yourself with the help of asciinema GIF generator utility - agg.

Once you have it installed, generate a GIF with the following command:

agg https://asciinema.org/a/243201 demo.gif

Or, if you already downloaded the recording file:

agg demo.cast demo.gif

Check agg --help for all available options. You can change font family and size, select color theme, adjust speed and more.

See agg manual for full usage instructions.