Skip to content

Minor Emacs mode to show buffer position using a Pokémon!

License

Notifications You must be signed in to change notification settings

RyanMillerC/poke-line

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

poke-line

MELPA

Minor Emacs mode to show buffer position using a Pokémon!

Demo GIF

Select from all 890 different Pokémon! Change Pokémon on the fly! Set a different Pokémon for each mode!

Installation

poke-line is available through MELPA. You will need to enable MELPA in your Emacs configuration before installing poke-line.

I recommend installing poke-line with use-package in your Emacs configuration:

(use-package poke-line
  :ensure t)

Alternatively, this package can be installed with package-install:

M-x package-install RET poke-line

Usage

poke-line can be activated with:

(poke-line-global-mode 1)

The chosen Pokémon can be selected with:

(poke-line-set-pokemon "charmander")

The command above is also interactive so Pokémon can be swapped on the fly:

M-x poke-line-set-pokemon "charmander"

You can also choose a random Pokémon using the poke-line-set-random-pokemon command.

Easily set the default Pokémon in your config with use-package:

(use-package poke-line
  :ensure t
  :config
  (poke-line-global-mode 1)
  (setq-default poke-line-pokemon "gengar"))

See this page for a list of available Pokémon.

Customization

poke-line allows for several custom variables to be set. (If setting them programmatically code, you may need to call poke-line-refresh.)

poke-line-pokemon

This is the name of the desired Pokémon.

(setq poke-line-pokemon "charmander")

poke-line-minimum-window-width

Minimum width of the window, below which poke-line-mode will not be displayed. This is important because poke-line-mode will push out all information from small windows.

(setq poke-line-minimum-window-width 64)

poke-line-bar-length

Length of Poke element bar in units. Each unit is equal to an 8px image. Minimum of 3 units are required for poke-line.

(setq poke-line-bar-length 32)

Credits

Software was inspired and forked from nyan-mode.

Pokémon sprites were obtained from PokemonDB.net and processed with this tool.

Pokémon is property of Nintendo/Creatures Inc./GAME FREAK inc. Legal information on fan projects is available here.

About

Minor Emacs mode to show buffer position using a Pokémon!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published