/README.org
http://github.com/TeMPOraL/nyan-mode · Org · 108 lines · 81 code · 27 blank · 0 comment · 5 complexity · 16ac8b09a8441fb8058e7bd2fa6b8f2b MD5 · raw file
- * Nyan Mode - Turn your Emacs into Nyanmacs! :)
- [[https://github.com/TeMPOraL/nyan-mode][file:https://badge.fury.io/gh/TeMPOraL%2Fnyan-mode.svg]]
- [[http://www.nyan.cat/][file:https://img.shields.io/badge/nyan-nyan-ff00ff.svg]]
- [[https://stable.melpa.org/#/nyan-mode][file:https://stable.melpa.org/packages/nyan-mode-badge.svg]]
- [[https://melpa.org/#/nyan-mode][file:https://melpa.org/packages/nyan-mode-badge.svg]]
- [[https://doi.org/10.5281/zenodo.164185][file:https://zenodo.org/badge/DOI/10.5281/zenodo.164185.svg]]
- *WARNING, MIND DUMBING CONTENT INSIDE.*
- #+BEGIN_QUOTE
- "Nyan-mode. It's things like this that make me proud to be an emacs user." - [[http://twitter.com/#!/mitchellh/status/104931263479156736][mitchellh]]
- #+END_QUOTE
- #+BEGIN_QUOTE
- "Everything that's wrong (or right) with Emacs." - [[https://youtu.be/NBArWrn6FnY?t=756][wasamasa]]
- #+END_QUOTE
- Nyanmacs is expanding!! [[http://jacek.zlydach.pl/blog/2011-08-25-introducing-nyan-mode-el-turn-your-emacs-into-nyanmacs.html][Read the story so far]]! :).
- [[file:screenshot.png]]
- Nyan Mode is an analog indicator of your position in the buffer. The
- Cat should go from left to right in your mode-line, as you move your
- point from 0% to 100%.
- ** Features
- - *NEW!* You can scroll the buffer by clicking in the Nyan Cat area!
- - *NEW!* You can customize the minimum window width below which Nyan Mode will be disabled.
- - Mind dumbing content included,
- - Animation (=M-x nyan-start-animation=, =M-x nyan-stop-animation=),
- - Wavy rainbow (=M-x nyan-toggle-wavy-trail=),
- - Music, mplayer is needed (=M-x nyan-start-music=, =M-x nyan-stop-music=) (thanks, George Leontiev!),
- - Customizable properties.
- ** Customizations
- - =nyan-animate-nyancat= - =t= to have it animated, =nil= for a static version.
- - =nyan-animation-frame-interval= - number of seconds between animation frames. Accepts fractional values.
- - =nyan-bar-length= - length of nyan-mode bar, in 8px-wide units.
- - =nyan-cat-face-number= - choose a cat face for the console mode.
- - =nyan-wavy-trail= - =t= to make the trail wavy; works even better when animation is enabled!
- - =nyan-minimum-window-width= - minimum width of the window, below
- which Nyan Mode will be disabled. This is important because Nyan
- Mode will otherwise push out more relevant information from the
- modelilne.
- ** Using Nyan Mode with custom modeline
- For those who were asking, or are planning to, [[http://web.archive.org/web/20120131133230/http://friendfeed.com/amitp/b4097da0/nyan-mode-turn-your-emacs-into-nyanmacs][Amit Patel shared]]
- some tips on how to make nyan-mode work with custom modeline.
- He changed his mode-line-format to appear like the following:
- #+begin_src emacs-lisp
- (setq mode-line-format
- (list
- '(:eval (list (nyan-create)))
- ))
- #+end_src
- ** Known issues
- It's my second attempt to write a minor mode in Emacs, so there will
- definiely be some bugs.
- This version uses XPM images, which should be supported by default by
- most Emacs 23 installations, Windows included. In case it doesn't
- work, try switching to master-png branch. This branch, however, may
- have it's own issues:
- There was a problem with displaying PNG images, which require libpng
- to be available for Emacs. The lib is sometimes missing (e.g. some
- Windows installation). To make it work on Windows, one needs to
- download a proper DLL and put it into emacs bin/ folder. To see which
- DLL is needed, do: =M-x describe-variable <ret> image-library-alist <ret>=.
- +Customizing nyan-animate-nyancat is broken; don't do it.+
- I think it works now; please report issues if there are problems with it.
- ** Credits
- Thanks to everyone contributing patches, bug repots and ideas! The Emacs world is forever in your debt!
- Code and idea inspired by sml-modeline.el, written by Lennart Borgman.
- See: http://bazaar.launchpad.net/~nxhtml/nxhtml/main/annotate/head%3A/util/sml-modeline.el
- For animated Nyan Cat, I used frames [[http://media.photobucket.com/image/nyan%20cat%20sprites/DryBowser455/th_NyanCatSprite.png?t=1304659408][by DryBowser455]].
- ** Other editors
- For many years only the [[https://www.gnu.org/software/emacs/][One True Editor]] was blessed with the presence
- of the Nyan Cat. Since its inception, however, daring souls have brought
- Nyanness to the lands of Lesser Editors.
- Here are the examples I've tracked down so far:
- - Vim - nefo-mi's [[https://github.com/nefo-mi/nyan-modoki.vim][nyan-modoki.vim]] (text-only, it seems)
- - Vim - edvb54's [[https://github.com/edvb54/catium.vim][catium.vim]] (also text, apparently)
- - Sublime Text - wiggin15's [[https://github.com/wiggin15/SublimeNyan][SublimeNyan]]
- - Atom - dz's [[https://github.com/dz/atom-nyancat][atom-nyancat]]
- - qutebrowser - [[https://github.com/jgkamat/qutenyan][qutenyan]]
- If you've seen others in the wild, please submit.
- ** Related
- Check out Aaron Miller's [[https://github.com/aaron-em/weatherline-mode.el][weatherline.el]], partially inspired by Nyan Mode.
- Also check out [[https://github.com/wasamasa/zone-nyan][zone-nyan]] by Vasilij Schneidermann if you want the Nyan
- Cat to visit your Emacs when you step away from the keyboard!
- Nyanyanyanyanyanyanya! ♬ ♫ ♪ ♩