Python库 | ttygif-1.2.209.tar.gz

# ttygif A full featured text to gif conversion utility, that just works. It's in beta, so expect rough edges. ## Why use ttygif? - its fast, and easy to install - can be used with a pipe - it can be scripted - it can read asciicast files - it runs headless - perfect fit for CI/CD - works with python 2 and 3 - works on linux, mac, raspberry PI ## easy install ```bash ## requirements gcc and python development libs pip install ttygif --user ``` ## dev install This will pull the project and submodule assets from github. ``` git clone https://github.com/chris17453/ttygif.git cd ttygif make pull-assets ``` ## dev build ```bash pipenv shell make build ``` ## It's portable ttygif is self contained with no dependencys other than python. GIF encoding and termal emulation are both implimented with internal cython code. No system fonts are required. All you need to get ttygif to work is a c compiler, python and its development libs. ttygif is a cython project. ## usage ``` ttygif version [1.2.175] - Compiled against Python: 3.9.6 (default, Jul 16 2021, 00:00:00) [GCC 11.1.1 20210531 (Red Hat 11.1.1-3)] usage: ttygif [-h] [--input FILE] [--output FILE] [--loop COUNT] [--delay MS] [--record FILE] [--font NAME] [--theme THEME] [--dilation RATE] [--fps FPS] [--columns WIDTH] [--rows HEIGHT] [--debug] tty output to gif optional arguments: -h, --help show this help message and exit --input FILE, -i FILE asciinema .cast file (default: None) --output FILE, -o FILE gif output file. will default to ttygif-xx (default: None) --loop COUNT, -l COUNT number of loops to play, 0=unlimited (default: 0) --delay MS, -d MS delay before restarting gif in milliseconds (default: 100) --font NAME, -f NAME which internal font to use (default: None) --theme THEME, -t THEME load custom theme: game,windows7,mac,fwdm (default: default) --dilation RATE process events at a faster or slower rate of time (default: 1) --fps FPS encode at (n) frames per second (0-25) 0=speed of cast file, min 3ms (default: 0) --columns WIDTH, -c WIDTH change character width of gif, default is 80 or what is in the cast file (default: None) --rows HEIGHT, -r HEIGHT change character height of gif, default is 25 or what is in the cast file (default: None) --debug show debuging statistics (default: None) ``` ## themes Theming is based on the idea of branding your work for display in project repositories, ci/cd and online. ### theme support - user directory. custom themes can be placed in the user directory under '~/.ttygif' - layers above and below the terminal image - transparency in layers - layers can be 1:1, 9slice (scale and tiled) - layers support cropping and positioning - palettes are defined by themes - all layers are mapped to this palette ### shipped themes - default (256 color xterm palette) - default-4bit (16 colorxterm palette) - default-2bit (monochrome palette) - windows7 (windows style wrapped terminal) - game (8 bit inspired frame) - mac (mac styled window) - fwdm (old linux style window) - scripted (bottom bar with text) - opensouirce (bottom bar with text) - bar (bottom bar with NO text) ## file size Gif's are not the best compresed video format, however ttygif has all ability the format allows. Bit reduction results in slightly smaller files For example The folowing table is made from the htop example: - Specs: 79 frames at 1 FPS for 13.5 seconds | COLORS | Bit Depth | Size | Change | |--------|-----------|------|--------| | 256 | 8 | 189k | 0% | | 16 | 4 | 175k | 7.5% | 2 | 2 | 133k | 29.7% | ## cast file to gif ```bash ttygif --input 232377.cast --output ls_pipe.gif --fps=33 ``` ## pipe to gif ```bash ls -lhatsR | ttygif --output ls_pipe.gif --fps=0 ``` ## slow down gif ```bash ls -lhatsR | ttygif --output ls_pipe.gif --fps=0 --dilate 10 ``` ## speed up gif ```bash ls -lhatsR | ttygif --output ls_pipe.gif --fps=0 --dilate .5 ``` ## Supported fonts - All fonts came from [https://int10h.org/oldschool-pc-fonts](https://int10h.org/oldschool-pc-fonts/) - copyright FON conversion © 2015 VileR, license: CC BY-SA 4.0 - ttygif supports the "fd" font format. Basicly text files. - All .FON files have been exported to fd files for portability. - All fonts are copyright of their perspective owners, not me. - default font=Verite_9x16 - AMI_BIOS -  - AmstradPC1512 -  - ATI_8x14 -  - ATI_8x16 -  - ATI_8x8 -  - ATI_9x14 -  - ATI_9x16 -  - ATI_SmallW_6x8 -  - ATT_PC6300 -  - CompaqThin_8x14 -  - CompaqThin_8x16 -  - CompaqThin_8x8 -  - DTK_BIOS -  - IBM_3270pc -  - IBM_BIOS -  - IBM_CGA -  - IBM_CGAthin -  - IBM_Conv -  - IBM_EGA8 -  - IBM_EGA9 -  - IBM_ISO8 -  - IBM_ISO9 -  - IBM_MDA -  - IBM_PGC -  - IBM_PS2thin1 -  - IBM_PS2thin2 -  - IBM_PS2thin3 -  - IBM_PS2thin4 - ![IBM_PS2thin4](https://raw.githubusercontent.com/chris1