Pokemon-Terminal-Theme

Features

• 700+ Pokemon
• Select Pokemon by name or by index number
• Ability to change the Desktop Wallpaper & the Terminal background
• Internal search system for finding Pokemon
• Supports iTerm2, ConEmu, Terminology, Windows Terminal, Windows Console, Tilix and Kitty terminal emulators
• Supports Windows, MacOS, GNOME, Openbox (with feh), i3wm (with feh) and sway for desktops

npm

You can install in any (npm-supported) OS using npm install --global pokemon-terminal-theme. Then just restart your terminal and type pokemon simisear for example. That's it, you're done!

Make sure you also have Python installed, npm won't automatically do that for you. (You may also need to run python -m pip install psutil first)

Usage

Command Line Arguments

usage: pokemon [-h] [-n NAME]
               [-r [{kanto,johto,hoenn,sinnoh,unova,kalos} [{kanto,johto,hoenn,sinnoh,unova,kalos} ...]]]
               [-l [0.xx]] [-d [0.xx]]
               [-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} ...]]]
               [-ne] [-e] [-ss [X]] [-w] [-v] [-dr] [-c]
               [id]

Set a pokemon to the current terminal background or wallpaper

positional arguments:
  id                    Specify wanted pokemon ID or exact (case
                        insensitive) name

optional arguments:
  -h, --help            show this help message and exit
  -c, --clear           Clears the current pokemon from terminal background
                        and quits.

Filters:
  Arguments used to filter the list of pokemons with various conditions that
  then will be picked

  -n NAME, --name NAME  Filter by pokemon which name contains NAME
  -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} ...]]
                        Filter pokemons by region
  -l [0.xx], --light [0.xx]
                        Filter out pokemons darker (lightness threshold
                        lower) then 0.xx (default is 0.7)
  -d [0.xx], --dark [0.xx]
                        Filter out pokemons lighter (lightness threshold
                        higher) then 0.xx (default is 0.42)
  -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} ...]]
                        Filter pokemons by type.
  -ne, --no-extras      Excludes extra pokemons (from extras folder)
  -e, --extras          Excludes all non-extra pokemons

Misc:
  -ss [X], --slideshow [X]
                        Instead of simply choosing a random pokemon from the
                        filtered list, starts a slideshow (with X minutes of
                        delay between pokemon) in the background with
                        pokemon that matched filters
  -w, --wallpaper       Changes desktop wallpaper instead of terminal
                        background
  -v, --verbose         Enables verbose output
  -dr, --dry-run        Implies -v and doesn't actually change either
                        wallpaper or background after the pokemon has been
                        chosen

Not setting any filters will get a completely random pokemon

Tips, tricks and common issues

iTerm2 settings

I 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.

Windows Terminal settings

You 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:

"backgroundImageOpacity": 0.5,
"useAcrylic": true,
"acrylicOpacity": 0.0

Adding Custom Images

The 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:

$ pokemon -e -dr

Alternatively, you can delete images from this folder and it will not break the program.

Solutions for Common Issues

• 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.

Terminology

Terminology already saves it automatically, just untick "temporary" in the settings after setting your desired Pokemon.

To show a random Pokemon each session:

1. Open ~/.bashrc in your favorite text editor.
2. Add the following lines to it:

   if [[ "$TERMINOLOGY" -eq "1" ]]; then
       pokemon
   fi

That 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.

How to Use:

Depending on your terminal theme, you may want to choose different themes for your terminal, as each Pokemon has a different background color, so it may be difficult to read text.

Random Pokemon Selection

Light/Dark Theme Random Selection

pokemon -l    # Random Pokemon for light themes
pokemon -d    # Random Pokemon for dark themes

Type Filtering

pokemon -t poison    # Random poison type Pokemon
pokemon -t fire      # Random fire type Pokemon
pokemon -t water     # Random water type Pokemon

Extra Pokemon Selection

pokemon -ne          # Random extra Pokemon
pokemon -e all       # All extra Pokemon (not random)

Basic Random Selection

pokemon -v           # Random Pokemon

Specific Pokemon Selection

By Name

pokemon -n char -v --wallpaper  # Shows all Pokemon with "char" in name

By Pokedex Number

pokemon 390           # For Chimchar

By Region

pokemon -r kanto -v --wallpaper  # Shows all Kanto Pokemon

Combine Filters

pokemon -n char -r kanto -v --wallpaper  # Shows Kanto Pokemon with "char" in name

By Type

pokemon -t fire -v --wallpaper  # Shows all fire types

Custom Images

pokemon -e -dr         # Shows all custom images

Wallpaper Management

Set as Desktop Wallpaper

pokemon --wallpaper    # Sets current Pokemon as desktop wallpaper

To remove from your wallpaper: Slide over to another desktop (Windows key + tab) and go back to whatever desktop you were on. Or, type bash pokemon -c to clear the current Pokemon from your wallpaper.

Slideshow Mode

pokemon -ss           # Slideshow mode - changes wallpaper every 10 minutes

Stop Slideshow

pokemon -c            # Stop wallpaper slideshow

Help and Information

pokemon --help        # See all available options

Popular Pokemon to Try

(Shown as desktop wallpaper. If you don't want it to show as desktop wallpaper and want to set it as your terminal wallpaper, remove the --wallpaper flag)

pokemon pikachu --wallpaper
pokemon charizard --wallpaper
pokemon mewtwo --wallpaper
pokemon blastoise --wallpaper
pokemon venusaur --wallpaper
pokemon gengar --wallpaper
pokemon dragonite --wallpaper

Reference

All Regions

• Kanto
• Johto
• Hoenn
• Sinnoh
• Unova
• Kalos

All Types

• Normal
• Fire
• Fighting
• Water
• Flying
• Grass
• Poison
• Electric
• Ground
• Psychic
• Rock
• Ice
• Bug
• Ghost
• Dark
• Steel
• Fairy
• Dragon