{"id":13682500,"url":"https://github.com/ninecath/nincat","last_synced_at":"2025-04-30T09:32:58.816Z","repository":{"id":45098193,"uuid":"427598238","full_name":"ninecath/nincat","owner":"ninecath","description":"A small, lightweight, and fun way to differentiate a new terminal from others *:｡･ﾟ.*ヽ(´∀｀ヽ) ","archived":false,"fork":false,"pushed_at":"2024-06-02T02:03:53.000Z","size":2275,"stargazers_count":10,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-08-02T13:34:14.171Z","etag":null,"topics":["ascii-art","colourful","fun","lolcat","nincat","posix","pre-release","shell","terminal","unix"],"latest_commit_sha":null,"homepage":"","language":"Nushell","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/ninecath.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"beyondmagic","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2021-11-13T07:29:46.000Z","updated_at":"2024-06-02T02:03:56.000Z","dependencies_parsed_at":"2024-04-20T16:29:31.354Z","dependency_job_id":"6dc61f9a-b4de-4aa7-991c-c73909edbef7","html_url":"https://github.com/ninecath/nincat","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ninecath%2Fnincat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ninecath%2Fnincat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ninecath%2Fnincat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ninecath%2Fnincat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ninecath","download_url":"https://codeload.github.com/ninecath/nincat/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224206091,"owners_count":17273388,"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":["ascii-art","colourful","fun","lolcat","nincat","posix","pre-release","shell","terminal","unix"],"created_at":"2024-08-02T13:01:47.152Z","updated_at":"2024-11-12T02:30:55.649Z","avatar_url":"https://github.com/ninecath.png","language":"Nushell","funding_links":["https://ko-fi.com/beyondmagic"],"categories":["Nushell"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cpre style=\"background: none !important;white-space: nowrap!important;font-weight:bold!important;\"\u003e\n             .,-:;//;:=,                \n          . :H@@@MM@M#H/.,+%;,          \n       ,/X+ +M@@M@MM%=,-%HMMM@X/,       \n     -+@MM; $M@@MH+-,;XMMMM@MMMM@+-     \n    ;@M@@M- XM@X;, -+XXXXXHHH@M@M#@/.   \n  ,%MM@@MH ,@%=            .---=-=:=,.  \n  =@#@@@MX .,              -%HX$$%%%+;  \n =-./@M@M$                  .;@MMMM@MM: \n X@/ -$MM/                    .+MM@@@M$ \n,@M@H: :@:                    . =X#@@@@-\n,@@@MMX, .                    /H- ;@M@M=\n.H@@@@M@+,                    @MM+..%#$.\n /MMMM@MMH/.                  XM@MH; =; \n  /%+%$XHH@$=              , .H@@@@MX,  \n   .=--------.           -%H.,@@@@@MX,  \n   .%MM@@@HHHXX$$$%+- .:$MMX =M@@MM%.   \n     =XMMM@MM@MM#H;,-+HMM@M+ /MMMX=     \n       ,:+$+-,/H#MMMMMMMMM@= =,         \n             =++%%%%+/:-.               \n\u003cbr\u003e\n$ echo 'An useless but fun way to show text-based art!'\u003c/pre\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\u003cb\u003eLet's revive the ASCII art!\u003c/b\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003eNincat is community-driven project that loads an ASCII art centred in your terminal.\u003c/p\u003e\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"http://asciiartist.com/wp/respect-ascii-artists-campaign/\"\u003e\n    \u003cimg src=\"https://www.asciiart.eu/images/respectasciiartists.gif\" alt\"Respect ASCII Artists Campaign\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/ninecath/\"\u003e\n    \u003cimg src=\"/.github/logo.png\" width=\"156\" alt\"ninecath\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n### Features:\n+ Fast as it can be and lightweight.\n+ Self adapt with the terminal size to print only ASCII arts that fit.\n+ Supports any external program such as lolcat.\n+ Supports HEX colour foreground/background arts and 256 colours, 88 colours, 16 colours.\n+ Skip empty ASCII art files.\n+ You can select an art directly (by option).\n+ List all ASCII art's paths (by option).\n+ Print the name of printed art (by option).\n+ Modular folder containing the ASCII arts.\n\n---\n\n### Installing\n\n\u003c!--\n#### Arch Linux (Manjaro, Artix, Arco...)\n\nWith an AUR helper, you can install it with the package called `nincat-git`.\nExample with [paru](https://github.com/Morganamilo/paru):\n\n```zsh\n# paru -S nincat-git\n$ nincat --random --center\n```\n--\u003e\n\n#### By Github\n\nClick in `Code` in this repository and then `Download ZIP`. Extract it using your favourite tool and then in your terminal: \n```nu\n\u003e cd PUT_HERE_THE_PATH_OF_NINCAT\n\u003e nincat random\n```\n\n#### By Git\n\nFrom your terminal, you can clone in your preferred folder:\n```nu\n\u003e git clone 'https://github.com/ninecath/nincat'\n\u003e cd nincat\n\u003e use ./nincat.nu\n\u003e nincat random\n```\n\n----\n\n### Tips\n\n\u003c!--\n#### List all arts.\n\nSome people may like or not a few arts, to remove you either take out the ASCII art-file or add it into a list to ignore it on `./ignore.txt`.\n\nFor example, if you don't like the Portal's ASCII art, just add the path to it!\n\n```\n....../nincat/ascii_arts/games/portal 19 40\n```\n\nThen run this again to update the list.\n\n```nu\n\u003e nincat setup\n```\n--\u003e\n\n#### Loading when your terminal emulator open.\n\nThat is, when your shell is loaded. There are many shells out there, a very famous one is `bash`.\n\nAnyway, all you need to do is add one line in your shell-r that runs nincat, then you'll be able to load it when the terminal opens :)\n\nTo verify what shell-rc you should have, run `$env.SHELL` or `echo $SHELL` (POSIX) in your terminal.\n\n+ For `zsh` the\trc is put in `~/.zshrc`;\n+ For `bash` the rc is put in `~/.bashrc`;\n+ For `fish` the config is put in `~/.config/fish/config.fish`;\n+ For `nu` the config is put in `~/.config/nushell/config.nu`.\n\n```nu\n\u003e nincat random\n```\n\n#### Creating ASCII/ANSI/TEXT-BASED art.\n\nTools that can be used to make easier this type of art can be found on Internet, here's a few of them:\n\n\u003c!--\nTools:\n+ [ninecath.github.io](https://github.com/ninecath/ninecath.github.io/) **[web]**\n+ ...\n--\u003e\n\n**Colours***\n\n[Give a look at this site for **256, 88, 16 colours** in your ASCII arts](https://misc.flogisoft.com/bash/tip_colors_and_formatting).\nAnd obviously, you should utilize `\\033` instead of `\\e`.\n\nFor RGB colours, [I'd recommend this lecture-commentary](https://stackoverflow.com/questions/4842424/list-of-ansi-color-escape-sequences).\n\n\n----\n\n\u003cp align=\"center\"\u003e\n  \u003cimg align=\"center\" src=\"./.github/gimp_art.png\" alt=\"Preview of one ASCII art with lolcat.\"/\u003e\n\u003c/p\u003e\n\n### Contributing/Adding ASCII arts:\n\nFile names are made in this format: `\u003cname-of-art\u003e`.\nThe spaces are important since we use them to rule out what arts should be printed.\n\nThe art files are put in the [`/assets/`](./assets). You can make a separate folder to add your own arts. Of course, update the list after with:\n```she\n$ nincat setup\n```\n\nPlease, do not fill all the lines with spaces to close all columns. A good and simple example should be:\nAnd do not use tabs, instead you should use spaces.\n```\n# Your wonderful username/name and/or extra information about authority (author).\n   (   )\n: ) o_o ( :\n```\n\n**Please, contribute!**\n\nIt would be lovely that for every art you add, you add it here, too! Remember to put your name in the first line, so your contribution is never forgotten :)\n\n- By Github's Pull Request (recommended)\n\nClone this project, add your art in a file in either manually with **Github** or with **git**, then send a pull request here comparing both branches.\n\n- By Github's Issue\n\nCreate a new issue in the `New art` type of issue and put your art there.\n\n----\n\n### Dependencies:\n+ **nushell**\n\u003c!--\n+ **lolcat** (optional)\n  - [You can use its faster implementation](https://github.com/jaseg/lolcat) for performance.\n  - You can disable this dependency by just renaming the `/ascii_arts/   _   lolcat` folder to anything else without the prefix `   _   ` in the root directory of `nincat`.\n+ **gay** (optional)\n  - [source](https://github.com/ms-jpq/gay)\n  - You can disable this dependency by just renaming the `/ascii_arts/   _   gay` folder to anything else without the prefix `   _   ` in the root directory of `nincat`.\n--\u003e\n\n---\n\n### Acknowledgements:\n\nYou can find alternatives in the web, here are some with their initial commits:\n\n+ [ASCII Art](https://github.com/Tianwei-Li/ascii_art) (2013/02);\n+ [ShASCII](https://github.com/oskargicast/shascii) (2014/05);\n+ [Art Splash Screen](https://github.com/DanCRichards/ASCII-Art-Splash-Screen) (2017/11);\n+ Inspired by [shell-colors-scripts](https://gitlab.com/dwt1/shell-color-scripts/) (2018/02);\n+ [TerminalWelcome](https://github.com/devarshi16/TerminalWelcome) (2019/03);\n+ [pokemon-colorscripts](https://gitlab.com/phoneybadger/pokemon-colorscripts/) (2021/08).\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"/LICENSE\"\u003e\u003cb\u003eGPL3 License\u003c/b\u003e\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fninecath%2Fnincat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fninecath%2Fnincat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fninecath%2Fnincat/lists"}