aboutsummaryrefslogtreecommitdiff
path: root/doc/emms.texinfo
diff options
context:
space:
mode:
authorYoni Rabkin <yoni@rabkins.net>2021-01-07 21:41:12 -0500
committerYoni Rabkin <yoni@rabkins.net>2021-01-07 21:41:12 -0500
commit82a90866f4c62aea92355197af9007be8e03c16c (patch)
tree1d6540525ef33e141bc9288c3f2be831fc666ab2 /doc/emms.texinfo
parent28acd31383471ebd013bd28668e5f62106b184fa (diff)
* doc/emms.texinfo: add setup example
Diffstat (limited to 'doc/emms.texinfo')
-rw-r--r--doc/emms.texinfo42
1 files changed, 42 insertions, 0 deletions
diff --git a/doc/emms.texinfo b/doc/emms.texinfo
index 840e38c..70662d4 100644
--- a/doc/emms.texinfo
+++ b/doc/emms.texinfo
@@ -372,6 +372,7 @@ Another way to change Emms variables is to use the M-x
@menu
* Finding files and speed:: Finding files quickly or portably.
+* Setup Examples:: Examples of ways to setup Emms.
@end menu
@@ -399,6 +400,47 @@ The method Emms will use is defined in the customisable variable
@var{emms-source-file-directory-tree-function}.
+@node Setup Examples
+@section Setup Examples
+
+@cindex example
+@cindex configuration
+
+What follow are samples from real-world Emms configurations which show
+the variety and breadth of modifications people make to the default
+Emms setup.
+
+This excerpt includes dbus integration, defining a "recent" filter for
+the @xref{The Browser}, persistent playlist via
+@file{emms-history.el}, and enabling sending track information with
+@file{emms-librefm-stream.el}:
+
+@lisp
+ ;; notifications
+ (require 'emms-dbus)
+ (emms-dbus-enable)
+ ;; covers
+ (setq emms-browser-covers #'emms-browser-cache-thumbnail-async)
+ (setq emms-browser-thumbnail-small-size 64)
+ (setq emms-browser-thumbnail-medium-size 128)
+ ;; filters
+ (emms-browser-make-filter "all" #'ignore)
+ (emms-browser-make-filter "recent"
+ (lambda (track) (< 30
+ (time-to-number-of-days
+ (time-subtract (current-time)
+ (emms-info-track-file-mtime track))))))
+ (emms-browser-set-filter (assoc "all" emms-browser-filters))
+ ;; history
+ (emms-history-load)
+ ;; libre-fm
+ (emms-librefm-scrobbler-enable)
+@end lisp
+
+
+
+
+
@c -------------------------------------------------------------------
@node Getting Help
@chapter Getting Help