{"id":15042476,"url":"https://github.com/guidofe/fortune-cat","last_synced_at":"2025-04-14T20:52:02.930Z","repository":{"id":55677298,"uuid":"318857003","full_name":"GuidoFe/fortune-cat","owner":"GuidoFe","description":"Like the cow, but it's a cat (and has many more options)","archived":false,"fork":false,"pushed_at":"2020-12-09T00:52:58.000Z","size":166,"stargazers_count":22,"open_issues_count":0,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-28T09:04:27.375Z","etag":null,"topics":["bash","bash-script","cowsay","fortune"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GuidoFe.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":"2020-12-05T18:11:53.000Z","updated_at":"2025-01-28T22:58:48.000Z","dependencies_parsed_at":"2022-08-15T06:20:16.686Z","dependency_job_id":null,"html_url":"https://github.com/GuidoFe/fortune-cat","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuidoFe%2Ffortune-cat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuidoFe%2Ffortune-cat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuidoFe%2Ffortune-cat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuidoFe%2Ffortune-cat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GuidoFe","download_url":"https://codeload.github.com/GuidoFe/fortune-cat/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248960956,"owners_count":21189990,"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":["bash","bash-script","cowsay","fortune"],"created_at":"2024-09-24T20:47:22.070Z","updated_at":"2025-04-14T20:52:02.904Z","avatar_url":"https://github.com/GuidoFe.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Fortune Cat\n\nLike the cow, but it's a cat (and has many more options). You can change the animal in a config file (to specify with -c) or with a dedicated file (-d).  \n  \nTake a look [here](https://github.com/GuidoFe/bashCatWithKitten) if you would like to have a cat to decor your `cat` command.\n## Requirements\n\nPython 3.0+, necessary for a simpler unicode manipulation.\n\n## How to install\n\nDownload the script manually, or run `pip3 install fortune-cat`\n\n## Examples\n\n![screen1](https://raw.githubusercontent.com/GuidoFe/fortune-cat/main/screen1.png)\n![screen2](https://github.com/GuidoFe/fortune-cat/blob/main/screen2.png)\n![screen3](https://raw.githubusercontent.com/GuidoFe/fortune-cat/main/screen3.png)\n\n## How to use\n\nBe sure to have Python3 and to make the script executable (`chmod +x ./catfortune.py`)\n\nYou can use it\n* With a pipe: `fortune | fortune-cat [OPTIONS]`\n* With a string: `fortune-cat [OPTIONS] \"Hello\"`\n\n## Options\n\nUsage: `fortune-cat OPTIONS [text]`\n\nYou can rename the file and/or remove the extension if you want\n\n### File Options\n\n| Command                   | Description                                  |\n|---------------------------|----------------------------------------------|\n| `-d, --drawing-file FILE` | File with a custom cat/animal/thinghy        |\n| `-c, --config-file FILE`  | Custom config file.                          |\n\n### Drawing Options\n\n| Command                     | Description                                                                                                  |\n|-----------------------------|--------------------------------------------------------------------------------------------------------------|\n| `-tl, --top-left STR`       | Top left corner character                                                                                    |\n| `-tr, --top-right STR`      | Top right corner char                                                                                        |\n| `-bl, --bottom-left STR`    | Bottom left corner char                                                                                      |\n| `-br, --bottom-right STR`   | Bottom right corner char                                                                                     |\n| `-l, --left STR`            | Left box char                                                                                                |\n| `-r, --right STR`           | Right box char                                                                                               |\n| `-t, --top STR`             | Top box char                                                                                                 |\n| `-b, --bottom STR`          | Bottom box char                                                                                              |\n| `-p, --padding INT`         | Vertical padding of the entire output                                                                        |\n| `-cp, --cat-position FLOAT` | Position from 0 to 1 of the cat relative to the box. 0 = all to the left, 1 = all to the right, 0.5 = center |  \n| `-gp, --global-position INT`| Position like --cat-position, but of the entire output relative to the terminal   \n\n### Text Options\n\n| Command                       | Description                                                                                    |\n|-------------------------------|------------------------------------------------------------------------------------------------|\n| `-tph, --text-padding-h INT`  | Horizontal text padding                                                                        |\n| `-tpv, --text-padding-v INT`  | Vertical text padding                                                                          |\n| `-tb, --tab-length INT`       | How many spaces a tab in the input text should be. Default = 2                                 |\n| `-mtl, --max-text-length INT` | Set a maximum length for the text. Default is 0, that means it will only adapt to the terminal |\n                        \n### Other\n\n| Command           | Description                   |\n|-------------------|-------------------------------|\n| `-h, --help`      | Print a guide to the script   |\n\n\n## Configuration files\n\n### Drawing file\n\nIt's the file where you can create a custom cat. Specify its path with the option `-d`.  \n\n- The first line must be the number of characters of the longest line of the drawing.\n- The orher lines are those of the drawing. **There must be `OUTPUT` as one of the lines**: it separates the top and the bottom part of the ASCII art.\n\nExample:\n\n```\n8\n  ∧＿∧\n ( ･ω･)\n─∪────∪─\nOUTPUT\n━┯━━━━┯━\n |    |\n |    |\n  U  U\n```\n\n### Config File\n\nSpecify its path with `-c`. It contains the same arguments as the command line options. You must specify them in a single line.  \nYou can optionally specify a custom drawing after the first line, with the same format as the drawing file. The latter will have precedence over the ASCII art in the config file.\n\nExample:\n```\n-tl ┌ -tph 3 -tpv 5 -l |\n8\n  ∧＿∧\n ( -.-)\n─∪────∪─\nOUTPUT\n━┯━━━━┯━\n |    |\n |    |\n  U  U\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguidofe%2Ffortune-cat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguidofe%2Ffortune-cat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguidofe%2Ffortune-cat/lists"}