{"id":15018499,"url":"https://github.com/statico/cadubi","last_synced_at":"2025-04-09T19:43:15.358Z","repository":{"id":36481996,"uuid":"40787566","full_name":"statico/cadubi","owner":"statico","description":":art: Creative ASCII Drawing Utility By Ian (1997)","archived":false,"fork":false,"pushed_at":"2019-08-20T17:37:12.000Z","size":79,"stargazers_count":49,"open_issues_count":1,"forks_count":4,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-23T21:45:47.982Z","etag":null,"topics":["ansi-art","ansi-colors","ascii-art","cli","command-line","console","editor","graphics","perl","unix"],"latest_commit_sha":null,"homepage":"","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/statico.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-08-15T21:58:53.000Z","updated_at":"2025-02-24T07:37:32.000Z","dependencies_parsed_at":"2022-08-30T15:31:01.741Z","dependency_job_id":null,"html_url":"https://github.com/statico/cadubi","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/statico%2Fcadubi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/statico%2Fcadubi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/statico%2Fcadubi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/statico%2Fcadubi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/statico","download_url":"https://codeload.github.com/statico/cadubi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248101420,"owners_count":21047969,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansi-art","ansi-colors","ascii-art","cli","command-line","console","editor","graphics","perl","unix"],"created_at":"2024-09-24T19:52:02.517Z","updated_at":"2025-04-09T19:43:15.333Z","avatar_url":"https://github.com/statico.png","language":"Perl","funding_links":[],"categories":["Softwares 💻"],"sub_categories":[],"readme":"# CADUBI - Creative ASCII Drawing Utility By Ian\n\nThis Perl program was written sometime around 1997 -- many years before I knew\nanything about Perl or Unix -- and the code hasn't changed much since then. It\nhas, however, become very widely adopted and is available as a package on most\nLinux distributions.\n\nCADUBI is an application written in Perl that allows you to draw\ntext-based images that are viewable on typical unix-based consoles.\nUsually the applications that emulate these consoles support various\ntext modes, such as background and foreground colors, bold, and\ninverse. This text art, commonly called \"ASCII art,\" is used in\nvarious places such as online BBSes, email and login prompts.\n\n\u003cimg src=\"https://raw.githubusercontent.com/statico/cadubi/master/screenshots/catfile.png\" width=\"150\"/\u003e \u003cimg src=\"https://raw.githubusercontent.com/statico/cadubi/master/screenshots/edit.png\" width=\"150\"/\u003e \u003cimg src=\"https://raw.githubusercontent.com/statico/cadubi/master/screenshots/help.png\" width=\"150\"/\u003e\n\n## Installation\n\n* [Homebrew](http://brew.sh/): `brew install cadubi`\n* [Debian](https://packages.debian.org/wheezy/cadubi) and [Ubuntu](http://packages.ubuntu.com/precise/cadubi): `apt-get install cadubi`\n* From source:\n  * Perl 5.002 or later\n  * `Term::ReadKey` Perl module\n\n## Usage\n\nCADUBI has a 'pen' which describes the current mode. Properties of\nthe pen are the painting character, foreground color, background\ncolor, bold, inverse, and blink. Whenever you paint or use the text\nmode, the characters drawn on the screen will have the properties of\nthe pen. The current mode of the pen is shown at the bottom of the\nconsole and is what will be drawn on screen when you paint.\n\nMove around the cursor with the \u003ckbd\u003ei\u003c/kbd\u003e, \u003ckbd\u003ej\u003c/kbd\u003e, \u003ckbd\u003ek\u003c/kbd\u003e and \u003ckbd\u003el\u003c/kbd\u003e keys. Holding\ndown shift and typing these keys will move the cursor five spaces\ninstead of one. Pressing return/enter will move the cursor down one\nline and all the way to the left of the console.\n\nTo paint the current pen on the screen, press the space bar. To\ndelete a character, press the delete/backspace key. You'll notice\nthat editing is much like common text editors, such as pico or joe.\nYou can also delete with the \u003ckbd\u003etilde\u003c/kbd\u003e key, which makes moving \u0026 painting\n(right hand) and erasing (left hand) much easier.\n\nThe pen character is the character that is drawn when you paint using\nthe space bar. To change the character, press \u003ckbd\u003ep\u003c/kbd\u003e and then the\ncharacter you would like it to be.\n\nTo set the foreground or background colors for the cursor, press \u003ckbd\u003ef\u003c/kbd\u003e\nfor foreground or \u003ckbd\u003eb\u003c/kbd\u003e for background, and then a corresponding color\n    code. The color codes are case-insensitive and are listed below:\n\n     0 or N   Normal (standard text)\n     1 or W   White\n     2 or R   Red\n     3 or G   Green\n     4 or Y   Yellow\n     5 or B   Blue\n     6 or M   Magenta\n     7 or C   Cyan\n     8 or K   Black\n     \nIf you can't remember the codes above, you can always hit \u003ckbd\u003eCtrl-h\u003c/kbd\u003e\nto view the Quick Help which will display a summary of all the keys,\ncolor codes and examples of how they look.\n\nTypically, foreground text colors are the same as background colors,\nunless the text is bold. If the text is bold, foreground colors are\nusually lighter than the background color, making text easier to read\nwhen the text has the same foreground and background color. Refer to\nthe Quick Help (\u003ckbd\u003eCtrl-h\u003c/kbd\u003e) to see what the colors look like on your\nconsole.\n\nBold and inverse are two widely-supported modes. Bold is toggled with\nthe \u003ckbd\u003eg\u003c/kbd\u003e key, and inverse is toggled with the \u003ckbd\u003ev\u003c/kbd\u003e key. Blink, though\nregarded as highly annoying, can be toggled with by pressing\n\u003ckbd\u003eShift-w\u003c/kbd\u003e.\n\nText mode is an extremely useful feature. Once in the text mode you\ncan type as if you were using a normal text editor, and all the\ncharacters drawn onscreen will use the same mode as the pen. To enter\ntext mode, press the \u003ckbd\u003et\u003c/kbd\u003e key. To exit, press escape.\n\nTo exit the CADUBI application, press \u003ckbd\u003eCtrl-x\u003c/kbd\u003e. Quick help can be\naccessed by pressing \u003ckbd\u003eCtrl-h\u003c/kbd\u003e. In case it is needed, pressing\n\u003ckbd\u003eCtrl-w\u003c/kbd\u003e will refresh the entire screen by redrawing each\ncharacter.\n\n### Reading and writing files\n\nTo read a file and use it with CADUBI, type \u003ckbd\u003eCtrl-r\u003c/kbd\u003e. To write\na file, type \u003ckbd\u003eCtrl-o\u003c/kbd\u003e. You will be prompted for a filename.\n\nWhen CADUBI reads a file, it will only read as much that will fit in\nthe workspace (the area of the console minus the bottom row [status\nbar]). To gain more workspace, see the `-s` operator in 'COMMAND LINE\nUSAGE' below.\n\nCADUBI optimizes its output files to display properly and take up as\nlittle space as possible. All CADUBI output can be viewed with the\n'cat' utility.\n\n## Command line usage\n\n    Usage: cadubi [OPTIONS] [FILE]\n\n    Available options:\n      -h, --help              what you're looking at now\n      -m, --mute              turn off beeping\n      -s, --size [W] [H]      sets the size of the console for use with\n                              CADUBI, where W is number of columns and H\n                              is number of rows.\n      -v, --version           show CADUBI version\n\n    Example:\n      Will make the cadubi workspace 160 columns wide, 48 rows high,\n      disable beeping, and open the file 'bacon.txt':\n      \n          cadubi --mute --size 160 48 bacon.txt\n\n      Will display the version of CADUBI, copyright and author:\n\n          cadubi -v\n\n## Tips\n\nWhenever you are prompted to type in information, such as the name of\na file to read/write to, you can hit escape to cancel. You can also\nhit escape to get out of text mode.\n\nWhen using the `-s` or `--size` command line option, make sure your\nconsole actually _is_ that size or the text won't wrap properly and\nCADUBI will look funny.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstatico%2Fcadubi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstatico%2Fcadubi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstatico%2Fcadubi/lists"}