{"id":15033505,"url":"https://github.com/lazocoder/pokemon-terminal","last_synced_at":"2025-03-04T21:17:49.759Z","repository":{"id":39350769,"uuid":"88655352","full_name":"LazoCoder/Pokemon-Terminal","owner":"LazoCoder","description":"Pokemon terminal themes.","archived":false,"fork":false,"pushed_at":"2024-07-18T07:00:16.000Z","size":69327,"stargazers_count":4215,"open_issues_count":41,"forks_count":226,"subscribers_count":52,"default_branch":"master","last_synced_at":"2024-10-29T15:05:11.117Z","etag":null,"topics":["bash","iterm2","linux","pikachu","pokemon","pokemon-terminal","style","terminal","terminology","theme","tilix"],"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/LazoCoder.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-04-18T18:04:54.000Z","updated_at":"2024-10-29T07:57:23.000Z","dependencies_parsed_at":"2024-11-09T13:42:21.813Z","dependency_job_id":null,"html_url":"https://github.com/LazoCoder/Pokemon-Terminal","commit_stats":{"total_commits":371,"total_committers":20,"mean_commits":18.55,"dds":0.706199460916442,"last_synced_commit":"ed8f7f4ebab6794e96398865f0f69df8f25048d0"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LazoCoder%2FPokemon-Terminal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LazoCoder%2FPokemon-Terminal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LazoCoder%2FPokemon-Terminal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LazoCoder%2FPokemon-Terminal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LazoCoder","download_url":"https://codeload.github.com/LazoCoder/Pokemon-Terminal/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241921958,"owners_count":20042768,"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","iterm2","linux","pikachu","pokemon","pokemon-terminal","style","terminal","terminology","theme","tilix"],"created_at":"2024-09-24T20:21:29.045Z","updated_at":"2025-03-04T21:17:49.734Z","avatar_url":"https://github.com/LazoCoder.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pokemon-Terminal\n\n[![Build Status](https://travis-ci.org/LazoCoder/Pokemon-Terminal.svg?branch=master)](https://travis-ci.org/LazoCoder/Pokemon-Terminal)\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://i.imgur.com/n34fXyp.png\" width=\"700\"/\u003e \u003c!--Pikachu--\u003e\n    \u003cimg src=\"https://i.imgur.com/bLajJfw.png\" width=\"430\"/\u003e \u003c!--Bulbasaur--\u003e\n    \u003cimg src=\"https://i.imgur.com/ZzQhJuE.png\" width=\"430\"/\u003e \u003c!--Squirtle--\u003e\n    \u003cimg src=\"https://i.imgur.com/54fvKOQ.png\" width=\"430\"/\u003e \u003c!--Charizard--\u003e\n    \u003cimg src=\"https://i.imgur.com/xaHPMUd.png\" width=\"430\"/\u003e \u003c!--Eevee--\u003e\n    \u003cimg src=\"https://i.imgur.com/W41EHr2.png\" width=\"430\"/\u003e \u003c!--Clefairy--\u003e\n    \u003cimg src=\"https://i.imgur.com/QjqQ6QQ.png\" width=\"430\"/\u003e \u003c!--Magikarp--\u003e\n    \u003cimg src=\"https://i.imgur.com/K7G2VW4.png\" width=\"430\"/\u003e \u003c!--Machop--\u003e\n    \u003cimg src=\"https://i.imgur.com/3z1WtCu.png\" width=\"430\"/\u003e \u003c!--Slowpoke--\u003e\n    \u003cimg src=\"https://i.imgur.com/u8cYbFp.png\" width=\"430\"/\u003e \u003c!--Muk--\u003e\n    \u003cimg src=\"https://i.imgur.com/54Ehhnk.png\" width=\"430\"/\u003e \u003c!--Porygon--\u003e\n    \u003cimg src=\"https://i.imgur.com/XEOwCXr.png\" width=\"430\"/\u003e \u003c!--Chansey--\u003e\n    \u003cimg src=\"https://i.imgur.com/smvCxHG.png\" width=\"430\"/\u003e \u003c!--Growlithe--\u003e\n    \u003cimg src=\"https://i.imgur.com/ZR5h5dZ.png\" width=\"430\"/\u003e \u003c!--Scyther--\u003e\n    \u003cimg src=\"https://i.imgur.com/I4TakUm.png\" width=\"430\"/\u003e \u003c!--Omanyte--\u003e\n    \u003cimg src=\"https://i.imgur.com/165hq6O.png\" width=\"430\"/\u003e \u003c!--Corsola--\u003e\n    \u003cimg src=\"https://i.imgur.com/H0AhgW5.png\" width=\"430\"/\u003e \u003c!--Mewtew--\u003e\n    \u003cimg src=\"https://i.imgur.com/jF2DMqO.png\" width=\"430\"/\u003e \u003c!--Azumarill--\u003e\n    \u003cimg src=\"https://i.imgur.com/G0LpD66.png\" width=\"430\"/\u003e \u003c!--Snubbull--\u003e\n    \u003cimg src=\"https://i.imgur.com/zirtgZq.png\" width=\"430\"/\u003e \u003c!--Wobbuffet--\u003e\n    \u003cimg src=\"https://i.imgur.com/O49I1gE.png\" width=\"430\"/\u003e \u003c!--Tyranitar--\u003e\n    \u003cimg src=\"https://i.imgur.com/SCe91Uv.png\" width=\"430\"/\u003e \u003c!--Lugia--\u003e\n    \u003cimg src=\"https://i.imgur.com/5vllDok.png\" width=\"430\"/\u003e \u003c!--Kyogre--\u003e\n    \u003cimg src=\"https://i.imgur.com/3YSj8MB.png\" width=\"430\"/\u003e \u003c!--Rayquaza--\u003e\n    \u003cimg src=\"https://i.imgur.com/YW5pSkZ.png\" width=\"430\"/\u003e \u003c!--Deoxys--\u003e\n    \u003c!--\u003cbr\u003e\u003ca href=\"https://imgur.com/a/0wfFm\" target=\"_blank\"\u003eMore previews\u003c/a\u003e--\u003e\n\u003c/p\u003e\n\n# Features\n- 719 unique Pokemon\n- Select Pokemon by name or by index number\n- Ability to change the Desktop Wallpaper \u0026 the Terminal background\n- Internal search system for finding Pokemon\n- Supports iTerm2, ConEmu, Terminology, Windows Terminal, Tilix and Kitty terminal emulators\n- Supports Windows, MacOS, GNOME, Openbox (with feh), i3wm (with feh) and sway for desktops\n\n# Installation\n\nInstall Python 3.7 or higher:\n- [For Mac](https://www.python.org/downloads/mac-osx/)\n- For Windows: [desktop](https://www.python.org/downloads/windows/) or [Microsoft Store](https://www.microsoft.com/p/python-38/9mssztt1n39l)\n- [For Ubuntu](https://askubuntu.com/a/865569)\n- [For Arch Linux](https://www.archlinux.org/packages/extra/x86_64/python/)\n- Not all compatible distros are named here, but a quick Google search should give you instructions for your distribution of choice.\n\nGet a compatible terminal emulator:\n- [iTerm2](https://iterm2.com/)\n- [ConEmu](https://conemu.github.io/) or derivative (such as [Cmder](http://cmder.net/))\n- [Terminology](https://www.enlightenment.org/about-terminology)\n- [Tilix](https://gnunn1.github.io/tilix-web/)\n- [Windows Terminal](https://www.microsoft.com/p/windows-terminal-preview/9n0dx20hk701)\n- [Kitty](https://sw.kovidgoyal.net/kitty/) from version `0.27.0` onwards\n\nYou can then proceed with one of the following methods for installation:\n- [Arch Linux User Repository package (System-wide)](https://aur.archlinux.org/packages/pokemon-terminal-git/) (maintained by [@sylveon](https://github.com/sylveon))\n- [pip (System-wide or Per-User)](#pip)\n- [npm (Per-User only)](#npm)\n- [Distutils (System-wide or Per-User)](#distutils)\n\n## pip\n\nLinux users: Your distro might include `pip` in a different package than Python, make sure to have that installed.\n\nRun `pip3 install git+https://github.com/LazoCoder/Pokemon-Terminal.git`.\n\nIf you want a system-wide install, run the command as superuser or administrator.\n\nIf you want a per-user install, append the `--user` flag.\n\nYou might want to add the following directories to your `PATH` on a per-user install, to be able to call `pokemon` and `ichooseyou` everywhere:\n - Linux and macOS: `~/.local/bin`\n - Windows: (replace `X` by your Python minor version, for example, 8 for Python 3.8)\n   - `%AppData%\\Python\\Python3X\\Scripts` for a desktop installation of Python;\n   - `%LocalAppData%\\Packages\\PythonSoftwareFoundation.Python.3.X_qbz5n2kfra8p0\\LocalCache\\local-packages\\Python3X\\Scripts` for a Microsoft Store installation of Python (note that there's two `X` here).\n\nWhen the command completes, it's installed and ready to go!\n\n## npm\n\nObviously requires to have [Node.js](https://nodejs.org/) installed.\n\nYou can install in any (npm-supported) OS using `npm install --global pokemon-terminal`. That's it, you're done!\n\nMake sure you also have Python installed, `npm` won't automagically do that for you.\n\n## Distutils\n\nThis doesn't works on Microsoft Store installations of Python.\n\nYou can clone or [download](https://github.com/LazoCoder/Pokemon-Terminal/archive/master.zip) this repo, and run `python3 setup.py install` at the root of the repo.\n\nIf you want a system-wide install, run the command as superuser or administrator.\n\nIf you want a per-user install, append the `--user` flag. Look at the pip directives to add a per-user install to your `PATH`.\n\n# Usage\n\n```\nusage: pokemon [-h] [-n NAME]\n               [-r [{kanto,johto,hoenn,sinnoh,unova,kalos} [{kanto,johto,hoenn,sinnoh,unova,kalos} ...]]]\n               [-l [0.xx]] [-d [0.xx]]\n               [-t [{normal,fire,fighting,water,flying,grass,poison,electric,ground,psychic,rock,ice,bug,dragon,ghost,dark,steel,fairy} [{normal,fire,fighting,water,flying,grass,poison,electric,ground,psychic,rock,ice,bug,dragon,ghost,dark,steel,fairy} ...]]]\n               [-ne] [-e] [-ss [X]] [-w] [-v] [-dr] [-c]\n               [id]\n\nSet a pokemon to the current terminal background or wallpaper\n\npositional arguments:\n  id                    Specify the wanted pokemon ID or the exact (case\n                        insensitive) name\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -c, --clear           Clears the current pokemon from terminal background\n                        and quits.\n\nFilters:\n  Arguments used to filter the list of pokemons with various conditions that\n  then will be picked\n\n  -n NAME, --name NAME  Filter by pokemon which name contains NAME\n  -r [{kanto,johto,hoenn,sinnoh,unova,kalos} [{kanto,johto,hoenn,sinnoh,unova,kalos} ...]], --region [{kanto,johto,hoenn,sinnoh,unova,kalos} [{kanto,johto,hoenn,sinnoh,unova,kalos} ...]]\n                        Filter the pokemons by region\n  -l [0.xx], --light [0.xx]\n                        Filter out the pokemons darker (lightness threshold\n                        lower) then 0.xx (default is 0.7)\n  -d [0.xx], --dark [0.xx]\n                        Filter out the pokemons lighter (lightness threshold\n                        higher) then 0.xx (default is 0.42)\n  -t [{normal,fire,fighting,water,flying,grass,poison,electric,ground,psychic,rock,ice,bug,dragon,ghost,dark,steel,fairy} [{normal,fire,fighting,water,flying,grass,poison,electric,ground,psychic,rock,ice,bug,dragon,ghost,dark,steel,fairy} ...]], --type [{normal,fire,fighting,water,flying,grass,poison,electric,ground,psychic,rock,ice,bug,dragon,ghost,dark,steel,fairy} [{normal,fire,fighting,water,flying,grass,poison,electric,ground,psychic,rock,ice,bug,dragon,ghost,dark,steel,fairy} ...]]\n                        Filter the pokemons by type.\n  -ne, --no-extras      Excludes extra pokemons (from the extras folder)\n  -e, --extras          Excludes all non-extra pokemons\n\nMisc:\n  -ss [X], --slideshow [X]\n                        Instead of simply choosing a random pokemon from the\n                        filtered list, starts a slideshow (with X minutes of\n                        delay between pokemon) in the background with the\n                        pokemon that matched the filters\n  -w, --wallpaper       Changes the desktop wallpaper instead of the terminal\n                        background\n  -v, --verbose         Enables verbose output\n  -dr, --dry-run        Implies -v and doesn't actually changes either\n                        wallpaper or background after the pokemon has been\n                        chosen\n\nNot setting any filters will get a completely random pokemon\n```\n\nExample:\n\n![](https://i.imgur.com/DfA2lcd.gif)\n\n# Tips, tricks and common issues\n\n## iTerm2 settings\n\nI highly suggest making the font colors black and the terminal window transparent. Some of the images have both light and dark colours and so it can be difficult to see the text sometimes. Transparency resolves this issue. Since *Pokemon-Terminal* only changes the background, the transparency must be done manually:\n\n1. Navigate to iTerm2 \u003e Preferences \u003e Profiles \u003e Window\n2. Set the transparency to about half way.\n3. Hit the \"blur\" checkbox.\n4. Set the blur to maximum.\n5. Optionally you can set the blending to maximum to adjust the colors to look like the samples provided.\n\n![](https://i.imgur.com/xSZAGhL.png)\n\nThe result should look like this:\n\n![](https://i.imgur.com/82DAT97.jpg)\n\n## ConEmu settings\n\n1. From the menu under the symbol at left of title bar, navigate to Settings \u003e Main \u003e Background\n2. Set Darkening to maximum (255).\n3. Set Placement to Stretch.\n4. Click Save Settings.\n5. Optionally you apply transparency under Features \u003e Transparency.\n\n## Windows Terminal settings\n\nYou can, like in iTerm2, enable transparency. Simply press the down arrow in the tab bar and click settings. Once the JSON file opens, add the following settings under the `defaults` section:\n\n```json\n\"backgroundImageOpacity\": 0.5,\n\"useAcrylic\": true,\n\"acrylicOpacity\": 0.0\n```\n\nThe result should look like this:\n\n![](https://i.imgur.com/DZbiQHf.png)\n\n## Kitty settings\n\nTo dynamically set background images in kitty, we use its [remote control feature](https://sw.kovidgoyal.net/kitty/overview/#remote-control). It is not enabled by default, and can be configured to be password protected.\n\nThe way passwords work for kitty remote control is that you set one or more passwords, each granting some amount of permissions (see [the docs](https://sw.kovidgoyal.net/kitty/conf/#opt-kitty.remote_control_password) for details).\n\nHere's an example of how to set it up in `./config/kitty/kitty.conf`:\n\n```\n# Enable remote control (password protected)\nallow_remote_control password\n\n# Option 1: Allow setting the background image with a password\nremote_control_password \"missingno\" set-background-image\n\n# Option 2: Allow setting the background image without a password\n# (slightly less secure, a malicious actor could mess up your backgrounds)\nremote_control_password \"\" set-background-image\n```\n\nIf you choose option 1 (recommended), you still need to pass your chosen password when running `pokemon`, this works using the environment variable `KITTY_RC_PASSWORD` - i.e. you can run `KITTY_RC_PASSWORD=missingno pokemon`, or set the variable in any other way using your method of choice.\n\n## Adding Custom Images\n\nThe folder `pokemonterminal/Images/Extra` is for adding custom images. You can manually add backgrounds to this folder and they will be visible to the program. Only JPG format is supported. To see a list of all the custom backgrounds type:\n```bash\n$ pokemon -e -dr\n```\nAlternatively, you can delete images from this folder and it will not break the program. These are some custom backgrounds:\n\n![](https://i.imgur.com/gdGUucu.gif)\n\n## Solutions for Common Issues\n\n* If you experience a line at the top of the terminal after changing the Pokemon, you can remove it by typing in the `clear` command or opening a new terminal.\n![](https://i.imgur.com/5HMu1jD.png)\n\n* If you are using Tilix and the terminal background is not changing, try adjusting the transparency in your profile settings.\n* If you are experiencing issues with Terminology and are running on Ubuntu, make sure that you have installed the latest version:\n   ```bash\n   $ sudo add-apt-repository ppa:niko2040/e19\n   $ sudo apt-get update\n   $ sudo apt install terminology\n   ```\n\n## Saving\n\n### iTerm2\nTo save a background you will need to setup a startup command in the profile:\n1. Navigate to iTerm2 \u003e Preferences \u003e General\n2. Locate the field where it says *Send text at start* under *Command*.\n3. In that field type `pokemon -n [pokemon name]`. You can see an example in the image down below.\n   - Alternatively you can also type `pokemon` for a random theme each time you open up a new terminal.\n4. You can leave out `; clear` if you don't care about the line showing up at the top of the terminal.\n\n![](https://i.imgur.com/2d4qa9j.png)\n\n### ConEmu\nAfter setting your desired pokemon, from the menu under the symbol at left of title bar, navigate to Settings \u003e Main \u003e Background and click Save Settings.\n\n### Terminology\nTerminology already saves it automatically, just untick \"temporary\" in the settings after setting your desired Pokemon:\n![](http://i.imgur.com/BTqYXKa.png)\n\nTo show a random Pokemon each session:\n1. Open `~/.bashrc` in your favorite text editor.\n2. Add the following lines to it:\n   ```bash\n   if [[ \"$TERMINOLOGY\" -eq \"1\" ]]; then\n       pokemon\n   fi\n   ```\nThat will simply pick a completely random Pokemon each session, but the `pokemon` line is simply calling the app, so you can still filter with regions, darkness, and etc. like you normally would, or you can also reset to a preset Pokemon every time you start.\n\n# Notes \u0026 Credits\n\n- Nearly all of the Pokemon backgrounds were created by [Teej](https://pldh.net/gallery/the493).\n- Originally the images were about 100mb in total but [ImageOptim](https://imageoptim.com/) was used to compress them down to about 17mb.\n- Since the images are compressed, some of them may have some mild (but negligible) compression artifacts.\n- Platforms:\n  - Thanks to [@samosaara](https://github.com/samosaara) for the Linux (GNOME and Terminology) port.\n  - Thanks to [@jimmyorourke](https://github.com/jimmyorourke) for the Windows (ConEMU and wallpaper) port.\n  - Thanks to [@sylveon](https://github.com/sylveon) for the Windows slideshow functionality and maintaining the AUR package.\n- Terminal \u0026 wallpaper support:\n  - Thanks to [@MattMattV](https://github.com/MattMattV) for adding Tilix support.\n  - Thanks to [@regenbogencode](https://github.com/regenbogencode) for sway support.\n  - Thanks to [@kyle-seongwoo-jun](https://github.com/kyle-seongwoo-jun) for Windows Terminal support.\n- Thanks to [@DrMartinLutherXing](https://github.com/DrMartinLutherXing) for some bug fixes.\n- Thanks to [@joanbono](https://github.com/joanbono) for the easy installation script in the readme.\n- Thanks to [@BnMcG](https://github.com/BnMcG) for the region specific randomize function.\n- Thanks to [@therealklanni](https://github.com/therealklanni) for adding the project to npm.\n- Thanks to [@connordinho](https://github.com/connordinho) for enhancing the slideshow functionality.\n- Thanks to [@cclauss](https://github.com/cclauss) for simplifying the code in the database class and the main class, as well as general code quality fixes.\n- Thanks to [@Fiskie](https://github.com/Fiskie) for implementing the adapter design pattern, piping commands and more.\n- Thanks to [@marcobiedermann](https://github.com/marcobiedermann) for better image compression.\n- Thanks to [@kamil157](https://github.com/kamil157) and [@dosman711](https://github.com/dosman711) for the randomized slideshow function.\n- Thanks to [@Squirrels](https://github.com/Squirrels) for adding Pokemon from the Unova and Kalos regions.\n- Thanks to [@caedus75](https://github.com/caedus75) for pip and reorganizing the files \u0026 folders.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flazocoder%2Fpokemon-terminal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flazocoder%2Fpokemon-terminal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flazocoder%2Fpokemon-terminal/lists"}