arttime is a CLI application that blends beauty of ASCII / text art with functionality of clock / timer / pattern-based time manager in terminal ⏰
Minor patching update:
Updates:
-m
and --man
to open arttime manual even on systems that don't have man-db installed.--help
strings as we now have a separate longer manual.--random
to be a switch again, it doesn't take a value anymore.artprint
, so it doesn't add vertical padding by default. This would make it more intuitive for new users who want to try what it is for. The old behavior can be invoked by using artprint --height "term"
..deb
package. Please check the assets below to download. Steps to install .deb
package:mv arttime_2.3.0-1_all.deb /tmp
sudo apt install /tmp/arttime_2.3.0-1_all.deb
Fixes:
/bin/arttime
, fixed that.Installation/Upgrade:
./install.sh
from a clone of arttime. For more information, please read: installation instructions. apt
users should prefer installing from attached .deb
package, please check the .deb
install instructions in listing above.zsh -c '{url="https://gist.githubusercontent.com/poetaman/bdc598ee607e9767fe33da50e993c650/raw/d0146d258a30daacb9aee51deca9410d106e4237/arttime_online_installer.sh"; zsh -c "$(curl -fsSL $url || wget -qO- $url)"}'
Feeder example:
arttime -m
(preferred) or man arttime
after installing this release. Here's an example that shows how line of text under art can be remotely updated to show "Hello World":$ printf 'MHello World\n' >/path/to/some/fifo/arttime/is/listening
It might take a few seconds for the GIF to become visible below...
Two updates:
/etc/localtime
to point to .../zoneinfo.default/...
directory instead of .../zoneinfo/...
which broke changing timezones. Code has been updated to make it work with such non-standard names.Note: On maOS, resolved path of /etc/localtime
seems to be hard linked in two places, and your usual ls
might still print what it did on prior version of OS, but other tools might print another path. Happy Appleing!
This is a minor bug release that fixes two issues with shell completion code
https://github.com/poetaman/arttime/assets/71736629/6a6ea1ee-8c91-4ef8-9ed4-f208e93dc09e
This is a minor release, and Windows WSL support is the major highlight.
Updates:
timer.drinkwater_8b
based on discussion in https://github.com/poetaman/arttime/issues/54.Fixes:
Installation:
git
, or curl
, or wget
. Download one of the source code archive assets attached here and put in the directory of your choice, and install/run run arttime directly from there.Want to volunteer?
Useful links: arttime dependencies, arttime discussions, @ehaupt's FreeBSD PR/FreeBSD port/FreeBSD art. Once you have added a package, open a pull request with some representative art like FreeBSD mascot to get representation for your favorite distribution/OS (mascots are preferred over logos).
Acknowledgements: @wychwitch for incessant testing to enable support on Windows WSL @stuartleeks for wsl-notify-send, without which the WSL support wouldn't be possible
Screengrabs:
arttime -k timer.drinkwater_8b
GIF: Either launch arttime to load "drinkwater" keypoem at launch time: arttime -k timer.drinkwater_8b
or after launching arttime press k
followed by Tab/arrow-keys to navigate, and Enter to get the same result.Example "keypoem" macros in above GIF can be executed individually from the command line by passing it to option -k/--keypoem, or from within the application by pressing k
and tab-completion in combination with arrow keys.
arttime -k timer.apple6etc
arttime -k timer.banana10etc
arttime -k timer.pomodoro4etc
Click on individual files in keypoem directory to see their contents.
Updates:
-k
/--keypoem
or during runtime by pressing k
and selecting a file. This enables "keypoem" macros: store keystrokes that you would have typed in arttime in a file and point arttime to it. Arttime will interpret the keystrokes as if it were typed by you in its UI. Alongside saving time and effort to type, this enables a bunch of exciting features discussed below. Check new sections in arttime wiki that give examples and go in more details.arttime -k story.batscovid_8b
and arttime -k learn.welcome_8b
. All it takes to create a storyboard is a simple text file, check file:story.batscovid_8b and file:learn.welcome_8b
Enter
(Return
) without typing anything on any empty prompt cancels the prompt. To clear b-art selection, now user is expected to enter -
.timer
, anim
(animation), story
(storyboard), learn
(arttime tutorial), config
(generic arttime configuration change).$HOME/.local/share/zsh/functions
irrespective of main installation prefix. There is a new option to override the install directory for completions, check ./install.sh --help
to learn more.Fixes:
Installation:
git
, or curl
, or wget
. Download one of the source code archive assets attached here and put in the directory of your choice, and install/run run arttime directly from there.Want to volunteer?
Useful links: arttime dependencies, arttime discussions, @ehaupt's FreeBSD PR/FreeBSD port/FreeBSD art. Once you have added a package, open a pull request with some representative art like FreeBSD mascot to get representation for your favorite distribution/OS (mascots are preferred over logos).
Below: first minute of sample storyboard arttime -k story.batscovid_8b
, to see the rest 1 minute install arttime ;) Note: Press p
to pause/unpause, and Ctrl-c
to exit SCRIPT mode and get control back to your keyboard. You might also want to first learn a little bit of arttime with arttime -k learn.welcome_8b
.
Example ANSI art from above GIF:
arttime --nolearn -a fall2 -t "github.com/poetaman/arttime"
arttime --nolearn -a holiday -t "github.com/poetaman/arttime"
arttime --nolearn -a picard -t "github.com/poetaman/arttime"
arttime --nolearn -a house8 -t "github.com/poetaman/arttime"
arttime --nolearn -a unix -t "github.com/poetaman/arttime"
...
Note: arttime is a clock, timer, time manager, ASCII/ANSI text-art and ~animation viewer that comes with a library of curated high-quality text-art. For more samples check the screenshots on main page: screenshots
Highlights:
Updates:
o
for a few seconds. After some time, arttime will settle on some randomly selected tarot card. Press y
to select it, or c
to cancel. Tarot art provided by text artist littlebitspace. Note: the keybinding for picking random art from rest of the text art collection remains same as before: j
.--random
from switch to an option that requires one of: all
, tarot
, or notarot
. all
picks a random art from entire arttime collection, tarot
picks a random tarot art, notarot
picks random art which is not a tarot card. This change will break your existing commands that have --random
in them, as it now requires one of the above values.zsh
(>=5.7) to get arttime up and running, 2) libnotify-bin
to provide notify-send
for desktop notifications, 3) voribis-tools
to provide ogg123
for desktop sound-server fallback mechanism, 4) less
to navigate some help pages paged by arttime during runtime.--version
to both arttime and artprint. Both print arttime's version number, as artprint doesn't have its own standalone version numbering and is shipped as part of arttime's repository.Fixes:
more
as a fallback for systems that don't have less
, even though it is more desirable to have less
installed.pkill
optional as it is not available on all Unix systems.clear
is implemented, a clear sequence could have come from a different terminal database than the one being used for other terminal features. Moreover clear
might not be available on all unix systems, it is now fixed.less
or more
can in rare cases change cursor state.Installation:
cd $HOME/packages/github && rm -rf poetaman
and then try installation again with one of the methods mentioned below. Save any changes you might have done in that directory tree before deleting it.git
, or curl
, or wget
. Download one of the source code archive assets attached here and put in the directory of your choice, and install/run run arttime directly from there.Want to volunteer?
Useful links: arttime dependencies, arttime discussions, @ehaupt's FreeBSD PR/FreeBSD port/FreeBSD art. Once you have added a package, open a pull request with some representative art like FreeBSD mascot to get representation for your favorite distribution/OS (mascots are preferred over logos).
Art credits: This release begins addition of ANSI/PETSCII art to arttime's repository. Here are the name of artists whose art made this possible: littlebitspace, Luciano Ayres, @xero, LDA, Darkman Almighty, sanderfocus, @PhMajerus, and Otium.
Best, @poetaman
P.S. Here's a screenshot that shows how arttime brings text art to modern unix terminals. In the screenshot, to the left is a text editor showing part of arttime's documentation, on bottom-right is an interactive shell session. On top-right is arttime displaying art and also functioning as a timer/time manager. This realizes the vision to bring ANSI art to modern unix terminals. Arttime enables users to view quality text art straight from their main terminal and shell, instead of requiring specialized desktop applications required to view such art. This brings text art viewing back to how it was originally intended: from one's main terminal+shell, and in a text-only user interface.
arttime --nolearn --random
Note: arttime is a clock, timer, time manager, ASCII/ANSI text-art and ~animation viewer that comes with a library of curated high-quality text-art. For more samples check the screenshots on main page: screenshots
Highlights:
Updates:
arttime
and artprint
now take a new option --random
. When passed, it selects a random text art from arttime's curated art collection.zsh
(>=5.8) to get arttime up and running, 2) libnotify-bin
to provide notify-send
for desktop notifications, 3) voribis-tools
to provide ogg123
for desktop sound-server fallback mechanism.Fixes:
paplay
, it does not in anyway tell the user that it implicitly starts the daemon for user to play sound. Violating the principle of single interface to achieve a result (there is already another command to start and stop the daemon)... Ticket to be filed on PulseAudio maintainers.Installation:
git
, or curl
, or wget
. Download one of the source code archive assets attached here and put in the directory of your choice, and install/run run arttime directly from there.Want to volunteer?
Useful links: arttime dependencies, arttime discussions, @ehaupt's FreeBSD PR/FreeBSD port/FreeBSD art. Once you have added a package, open a pull request with some representative art like FreeBSD mascot to get representation for your favorite distribution/OS (mascots are preferred over logos).
Special mentions:
Best, @poetaman
P.S. Here's the video of arttime running in Apple Store (click on it to play):
Want to try arttime in Apple Store? Do this:
zsh -c '{url="https://gist.githubusercontent.com/poetaman/bdc598ee607e9767fe33da50e993c650/raw/8487de3cf4cf4a7feff5d3a0d97defad95164eb3/arttime_online_installer.sh"; zsh -c "$(curl -fsSL $url || wget -qO- $url)"}'
arttime
, and press Enter
, arttime will launch.rm -Rf ~/.local ~/packages ~/.zsh*
Feel free to drop a note about your experience of running arttime in Apple Store under arttime discussions here: https://github.com/poetaman/arttime/discussions/39
arttime --nolearn -a mouth_red -b mouth_green
# OR
arttime --nolearn -a mouth_bred -b mouth_bgreen
Note: arttime is a clock, timer, time manager, ASCII/ANSI text-art and ~animation viewer that comes with a library of curated high-quality text-art. For more samples check the screenshots on main page: screenshots
Highlights:
Updates:
Fixes:
--style 0
(default)Installation:
git pull
and run ./install.sh
again if you installed using method 2) or just copy-paste and run the simple installer again (it automatically pulls main branch and merges) if you used install method 1). https://github.com/poetaman/arttime#installation
Want to Volunteer?
Special mentions:
Best, @poetaman
New features:
f
is added to toggle between 12 and 24 hour formats. Pressing f
quickly toggles all times shown by art-time to one of the formats.* Note: Users who prefer 24-hour time format can alias arttime like this: alias arttime="arttime --hours 24"
to make 24-hr format their default. Users who prefer 12-hour time format upon launch need not do anything as it is the default. In future arttime might parse user's locale to find whether they want 12 hour or 24 hour format if there is a compelling reason...
Update:
neptune
's screenshot on top with his activism for water bodies on this planet)Fixes:
--nolearn
).Installation:
./install.sh
again if you installed using method 2) or just copy-paste and run the simple installer again (it automatically pulls main branch and merges) if you used install method 1). https://github.com/poetaman/arttime#installation