A collection of visual effects that can be applied to terminal piped stdin text.
Project description
Terminal Text Effects
Inline Visual Effects in the Terminal
Table Of Contents
- About
- Requirements
- Installation
- Usage
- Options
- Examples
- In-Development Preview
- Recent Changes
- License
TTE
TerminalTextEffects is a collection of visual effects that run inline in the terminal. The underlying visual effect framework supports the following:
- Xterm 256 color and RBG hex color support
- Color gradients
- Runs inline, preserving terminal state and workflow
- Dynamic character movement with motion easing
- Dynamic animations with symbol and color changes and animation easing
- Effect customization through command line arguments
Requirements
TerminalTextEffects is written in Python and does not require any 3rd party modules. Terminal interactions use standard ANSI terminal sequences and should work in most modern terminals.
Note: Windows Terminal performance is slow for some effects.
Installation
pip install terminaltexteffects
OR
pipx install terminaltexteffects
Usage
cat your_text | tte <effect> [options]
OR
cat your_text | python -m terminaltexteffects <effect> [options]
- All effects support adjustable animation speed using the
-a
option. - Use
<effect> -h
to view options for a specific effect, such as color or movement direction.- Ex:
tte decrypt -h
- Ex:
Options
options:
-h, --help show this help message and exit
--xterm-colors Convert any colors specified in RBG hex to the closest XTerm-256 color.
--no-color Disable all colors in the effect.
--tab-width TAB_WIDTH
Number of spaces to use for a tab character.
--no-wrap Disable wrapping of text.
Effect:
Name of the effect to apply. Use <effect> -h for effect specific help.
{blackhole,bouncyballs,bubbles,burn,columnslide,crumble,decrypt,errorcorrect,expand,fireworks,middleout,pour,rain,randomsequence,rings,rowmerge,rowslide,scattered,spray,swarm,test,unstable,verticalslice,vhstape,waves}
Available Effects
blackhole Characters are consumed by a black hole and explode outwards.
bouncyballs Characters are bouncy balls falling from the top of the output area.
bubbles Characters are formed into bubbles that float down and pop.
burn Burns vertically in the output area.
columnslide Slides each column into place from the outside to the middle.
crumble Characters lose color and crumble into dust, vacuumed up, and reformed.
decrypt Display a movie style decryption effect.
errorcorrect Some characters start in the wrong position and are corrected in sequence.
expand Expands the text from a single point.
fireworks Characters launch and explode like fireworks and fall into place.
middleout Text expands in a single row or column in the middle of the output area then
out.
pour Pours the characters into position from the given direction.
rain Rain characters from the top of the output area.
randomsequence Prints the input data in a random sequence.
rings Characters are dispersed and form into spinning rings.
rowmerge Merges rows of characters.
rowslide Slides each row into place.
scattered Move the characters into place from random starting locations.
spray Draws the characters spawning at varying rates from a single point.
swarm Characters are grouped into swarms and move around the terminal before settling
into position.
test effect_description
unstable Spawn characters jumbled, explode them to the edge of the output area, then
reassemble them in the correct layout.
verticalslice Slices the input in half vertically and slides it into place from opposite
directions.
vhstape Lines of characters glitch left and right and lose detail like an old VHS tape.
waves Waves travel across the terminal leaving behind the characters.
Ex: ls -a | python -m terminaltexteffects --xterm-colors decrypt -a 0.002 --ciphertext-color 00ff00
--plaintext-color ff0000 --final-color 0000ff
Examples
Fireworks
Rain
Decrypt
Spray
Scattered
Expand
Burn
Pour
Rowslide
Rowmerge
Columnslide
Randomsequence
Verticalslice
Unstable
Bubbles
Bouncyballs
Middleout
Errorcorrect
Waves
Blackhole
Swarm
Crumble
Rings
VHStape
In-Development Preview
Any effects shown below are in development and will be available in the next release.
Recent Changes
0.5.0
New Features
- New effect, Vhstape. Lines of characters glitch left and right and lose detail like an old VHS tape.
- New effect, Crumble. Characters lose color and fall as dust before being vacuumed up and rebuilt.
- New effect, Rings. Characters are dispersed throughout the output area and form into spinning rings.
- motion.Motion.chain_paths(list[Paths]) will automatically register Paths with the EventHandler to create a chain of paths. Looping is supported.
- motion.Motion.find_coords_in_rect() will return a random selection of coordinates within a rectangular area. This is faster than using find_coords_in_circle() and should be used when the shape of the search area isn't important.
- Terminal.OutputArea.coord_in_output_area() can be used to determine if a Coord is in the output area.
- Paths have replaced Waypoints as the motion target specification object. Paths group Waypoints together and allow for easing motion and animations across an arbitrary number of Waypoints. Single Waypoint Paths are supported and function the same as Waypoints did previously. Paths can be looped with the loop argument.
- Quadratic and Cubic bezier curves are supported. Control points are specified in the Waypoint object signature. When a control point is specified, motion will be curved from the prior Waypoint to the Waypoint with the control point, using the control point to determine the curve. Curves are supported within Paths.
- New EventHandler.Event PATH_HOLDING is triggered when a Path enters the holding state.
- New EventHandler.Action SET_CHARACTER_ACTIVATION_STATE can be used to modify the character activation state based on events.
- New EventHandler.Action SET_COORDINATE can be used to set the character's current_coordinate attribute.
- Paths have a layer attribute that can be used to automatically adjust the character's layer when the Path is activated. Has no effect when Path.layer is None, defaults to None.
- New EventHandler.Events SEGMENT_ENTERED and SEGMENT_EXITED. These events are triggered when a character enters or exits a segment in a Path. The segment is specified using the end Waypoint of the segment. These events will only be called one time for each run through the Path. Looping Paths will reset these events to be called again.
Changes
- graphics.Animation.random_color() is now a static method.
- motion.Motion.find_coords_in_circle() now generates 7*radius coords in each inner-circle.
- BlackholeEffect uses chain_paths() and benefits from better circle support for a much improved blackhole animation.
- BlackholeEffect singularity Paths are curved towards center lines.
- EventHandler.Event.WAYPOINT_REACHED removed and split into two events, PATH_HOLDING and PATH_COMPLETE.
- EventHandler.Event.PATH_COMPLETE is triggered when the final Path Waypoint is reached AND holding time reaches 0.
- Fireworks effect uses Paths and curves to create a more realistic firework explosion.
- Crumble effect uses control points to create a curved vacuuming phase.
- graphics.Gradient accepts an arbitrary number of color stops. The number of steps applies between each color stop.
- motion.find_coords_in_circle() and motion.find_coords_in_rect() no longer take a num_points argument. All points in the area are returned.
Bug Fixes
- Fixed looping animations when synced to Path not resetting properly.
License
Distributed under the MIT License. See LICENSE for more information.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for terminaltexteffects-0.5.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | a8c5d8881016063e10a5e642370c71f1755fbb66e4c824e5c302cd5fab271464 |
|
MD5 | 883c011e6b91d8f4b8d64d8f4e50bbb9 |
|
BLAKE2b-256 | 8c5c0963c58da15e905a6e7c50429ce767ed0acd18f6d8604658b2097400d622 |
Hashes for terminaltexteffects-0.5.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3c7cd3531a3053ae6dec33a89d0ff05b31caf2487b6dc1ba75bb11331d7f837b |
|
MD5 | e4338605806d79df3264e903fb0e8d11 |
|
BLAKE2b-256 | e5887499ed2b1a7f9eb62006199e2ce65badbcc36aba0a476a19b0297d2cb8de |