/README.org

http://github.com/TeMPOraL/nyan-mode · Org · 108 lines · 81 code · 27 blank · 0 comment · 5 complexity · 16ac8b09a8441fb8058e7bd2fa6b8f2b MD5 · raw file

  1. * Nyan Mode - Turn your Emacs into Nyanmacs! :)
  2. [[https://github.com/TeMPOraL/nyan-mode][file:https://badge.fury.io/gh/TeMPOraL%2Fnyan-mode.svg]]
  3. [[http://www.nyan.cat/][file:https://img.shields.io/badge/nyan-nyan-ff00ff.svg]]
  4. [[https://stable.melpa.org/#/nyan-mode][file:https://stable.melpa.org/packages/nyan-mode-badge.svg]]
  5. [[https://melpa.org/#/nyan-mode][file:https://melpa.org/packages/nyan-mode-badge.svg]]
  6. [[https://doi.org/10.5281/zenodo.164185][file:https://zenodo.org/badge/DOI/10.5281/zenodo.164185.svg]]
  7. *WARNING, MIND DUMBING CONTENT INSIDE.*
  8. #+BEGIN_QUOTE
  9. "Nyan-mode. It's things like this that make me proud to be an emacs user." - [[http://twitter.com/#!/mitchellh/status/104931263479156736][mitchellh]]
  10. #+END_QUOTE
  11. #+BEGIN_QUOTE
  12. "Everything that's wrong (or right) with Emacs." - [[https://youtu.be/NBArWrn6FnY?t=756][wasamasa]]
  13. #+END_QUOTE
  14. 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]]! :).
  15. [[file:screenshot.png]]
  16. Nyan Mode is an analog indicator of your position in the buffer. The
  17. Cat should go from left to right in your mode-line, as you move your
  18. point from 0% to 100%.
  19. ** Features
  20. - *NEW!* You can scroll the buffer by clicking in the Nyan Cat area!
  21. - *NEW!* You can customize the minimum window width below which Nyan Mode will be disabled.
  22. - Mind dumbing content included,
  23. - Animation (=M-x nyan-start-animation=, =M-x nyan-stop-animation=),
  24. - Wavy rainbow (=M-x nyan-toggle-wavy-trail=),
  25. - Music, mplayer is needed (=M-x nyan-start-music=, =M-x nyan-stop-music=) (thanks, George Leontiev!),
  26. - Customizable properties.
  27. ** Customizations
  28. - =nyan-animate-nyancat= - =t= to have it animated, =nil= for a static version.
  29. - =nyan-animation-frame-interval= - number of seconds between animation frames. Accepts fractional values.
  30. - =nyan-bar-length= - length of nyan-mode bar, in 8px-wide units.
  31. - =nyan-cat-face-number= - choose a cat face for the console mode.
  32. - =nyan-wavy-trail= - =t= to make the trail wavy; works even better when animation is enabled!
  33. - =nyan-minimum-window-width= - minimum width of the window, below
  34. which Nyan Mode will be disabled. This is important because Nyan
  35. Mode will otherwise push out more relevant information from the
  36. modelilne.
  37. ** Using Nyan Mode with custom modeline
  38. 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]]
  39. some tips on how to make nyan-mode work with custom modeline.
  40. He changed his mode-line-format to appear like the following:
  41. #+begin_src emacs-lisp
  42. (setq mode-line-format
  43. (list
  44. '(:eval (list (nyan-create)))
  45. ))
  46. #+end_src
  47. ** Known issues
  48. It's my second attempt to write a minor mode in Emacs, so there will
  49. definiely be some bugs.
  50. This version uses XPM images, which should be supported by default by
  51. most Emacs 23 installations, Windows included. In case it doesn't
  52. work, try switching to master-png branch. This branch, however, may
  53. have it's own issues:
  54. There was a problem with displaying PNG images, which require libpng
  55. to be available for Emacs. The lib is sometimes missing (e.g. some
  56. Windows installation). To make it work on Windows, one needs to
  57. download a proper DLL and put it into emacs bin/ folder. To see which
  58. DLL is needed, do: =M-x describe-variable <ret> image-library-alist <ret>=.
  59. +Customizing nyan-animate-nyancat is broken; don't do it.+
  60. I think it works now; please report issues if there are problems with it.
  61. ** Credits
  62. Thanks to everyone contributing patches, bug repots and ideas! The Emacs world is forever in your debt!
  63. Code and idea inspired by sml-modeline.el, written by Lennart Borgman.
  64. See: http://bazaar.launchpad.net/~nxhtml/nxhtml/main/annotate/head%3A/util/sml-modeline.el
  65. For animated Nyan Cat, I used frames [[http://media.photobucket.com/image/nyan%20cat%20sprites/DryBowser455/th_NyanCatSprite.png?t=1304659408][by DryBowser455]].
  66. ** Other editors
  67. For many years only the [[https://www.gnu.org/software/emacs/][One True Editor]] was blessed with the presence
  68. of the Nyan Cat. Since its inception, however, daring souls have brought
  69. Nyanness to the lands of Lesser Editors.
  70. Here are the examples I've tracked down so far:
  71. - Vim - nefo-mi's [[https://github.com/nefo-mi/nyan-modoki.vim][nyan-modoki.vim]] (text-only, it seems)
  72. - Vim - edvb54's [[https://github.com/edvb54/catium.vim][catium.vim]] (also text, apparently)
  73. - Sublime Text - wiggin15's [[https://github.com/wiggin15/SublimeNyan][SublimeNyan]]
  74. - Atom - dz's [[https://github.com/dz/atom-nyancat][atom-nyancat]]
  75. - qutebrowser - [[https://github.com/jgkamat/qutenyan][qutenyan]]
  76. If you've seen others in the wild, please submit.
  77. ** Related
  78. Check out Aaron Miller's [[https://github.com/aaron-em/weatherline-mode.el][weatherline.el]], partially inspired by Nyan Mode.
  79. Also check out [[https://github.com/wasamasa/zone-nyan][zone-nyan]] by Vasilij Schneidermann if you want the Nyan
  80. Cat to visit your Emacs when you step away from the keyboard!
  81. Nyanyanyanyanyanyanya!