74 lines
2.4 KiB
Org Mode
74 lines
2.4 KiB
Org Mode
#+title: :app emms
|
|
#+subtitle: A media player for music no one's heard of
|
|
#+created: March 06, 2021
|
|
#+since: 21.12.0 (#3581)
|
|
|
|
* Description :unfold:
|
|
This module enables Emacs to be used as a music player. It uses [[https://www.musicpd.org/][mpd]] as a backend
|
|
server and [[https://musicpd.org/clients/mpc/][mpc]] to update your music database.
|
|
|
|
** Maintainers
|
|
/This module has no dedicated maintainers./ [[doom-contrib-maintainer:][Become a maintainer?]]
|
|
|
|
** Module flags
|
|
/This module has no flags./
|
|
|
|
** Packages
|
|
- [[doom-package:emms]]
|
|
|
|
** Hacks
|
|
/No hacks documented for this module./
|
|
|
|
** TODO Changelog
|
|
# This section will be machine generated. Don't edit it by hand.
|
|
/This module does not have a changelog yet./
|
|
|
|
* Installation
|
|
[[id:01cffea4-3329-45e2-a892-95a384ab2338][Enable this module in your ~doom!~ block.]]
|
|
|
|
This module requires:
|
|
- [[https://mpd.readthedocs.io/en/stable/user.html#installation][mpd]] (and a running mpd server)
|
|
- [[https://www.musicpd.org/clients/mpc/][mpc]]
|
|
|
|
These should be available through your OS package manager.
|
|
|
|
* TODO Usage
|
|
#+begin_quote
|
|
/This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]]
|
|
#+end_quote
|
|
|
|
** Keybinds
|
|
- [[kbd:][<localleader> l]] Toggles whether or not the player repeats the playlist.
|
|
- [[kbd:][<localleader> m]] Mixes the playlist.
|
|
- [[kbd:][<localleader> i]] Insert specific song
|
|
- [[kbd:][<localleader> s]] Save the current playlist to a file
|
|
- [[kbd:][<localleader> p]] Insert playlist save into current playlist
|
|
- [[kbd:][g a]] Sort the browser by artists
|
|
- [[kbd:][g b]] Sort the browser by genre
|
|
- [[kbd:][X]] Stops the player
|
|
- [[kbd:][x]] pauses the player
|
|
- [[kbd:][D]] in the playlist window removes that item
|
|
- [[kbd:][C]] clears the playlist
|
|
- [[kbd:][>]] move five seconds forward in the current track
|
|
- [[kbd:][<]] Opposite five back
|
|
- [[kbd:][RET]] In browser adds the artist's songs to the playlist, in the playlist starts
|
|
playlist.
|
|
|
|
* TODO Configuration
|
|
#+begin_quote
|
|
This module has no configuration documentation yet. [[doom-contrib-module:][Write some?]]
|
|
#+end_quote
|
|
|
|
* Troubleshooting
|
|
[[doom-report:][Report an issue?]]
|
|
|
|
** New music files not showing up in database
|
|
Try [[kbd:][M-x +emms/mpd-restart-music-daemon]] then restart emacs.
|
|
|
|
* Frequently asked questions
|
|
/This module has no FAQs yet./ [[doom-suggest-faq:][Ask one?]]
|
|
|
|
* TODO Appendix
|
|
#+begin_quote
|
|
This module has no appendix yet. [[doom-contrib-module:][Write one?]]
|
|
#+end_quote
|