(require 'seq)
-;;; Global constants
-;;
-
-(defconst emus-version "1.0.0"
- "Current version of emus.")
-
-
;;; Customizations
;;
:type '(string))
(defface emus-artist
- '((t :inherit font-lock-keyword-face :background "#333"))
+ '((t :inherit font-lock-string-face :background "#333"))
"Face used for artist names in browser.")
(defface emus-album
- '((t :inherit font-lock-function-name-face :background "#222"))
+ '((t :inherit font-lock-constant-face :background "#222"))
"Face used for album names in browser.")
(defface emus-track
- '((t :inherit font-lock-string-face))
+ '((t :inherit font-lock-keyword-face))
"Face used for track titles in browser.")
(defface emus-track-current
- '((t :inherit font-lock-string-face :inverse-video t))
+ '((t :inherit font-lock-keyword-face :inverse-video t))
"Face used for track titles in browser.")
(defface emus-cursor
'((t :inherit bold))
"Face used for current track cursor")
+;;; mpg123 process
+;;
+
+(defvar emus--proc-in-use nil
+ "If non-nil, disables `emus-send-cmd'.
+Used to prevent commands from interfering with library construction.")
+
+(defun emus-get-process ()
+ "Return current or new mpg123 process."
+ (let* ((emus-process-raw (get-process "emus-process"))
+ (emus-process (if emus-process-raw
+ (if (process-live-p emus-process-raw)
+ emus-process-raw
+ (kill-process emus-process-raw)
+ nil))))
+ (if emus-process
+ emus-process
+ (let ((proc
+ (make-process :name "emus-process"
+ ;; :buffer (get-buffer-create "*emus-process*")
+ :command `(,emus-mpg123-program "-R"))))
+ (set-process-query-on-exit-flag proc nil)
+ (process-send-string proc "silence\n")
+ proc))))
+
+(defun emus--send-cmd-raw (cmd &rest args)
+ "Send a command CMD with args ARGS to the mpg123 process.
+This procedure does not respect `emus--proc-in-use' and thus should only
+be used by `emus--load-library'."
+ (process-send-string (emus-get-process)
+ (concat
+ (seq-reduce (lambda (s1 s2) (concat s1 " " s2)) args cmd)
+ "\n")))
+
+(defun emus-send-cmd (cmd &rest args)
+ "Send a command CMD with args ARGS to the mpg123 process."
+ (unless emus--proc-in-use
+ (apply #'emus--send-cmd-raw cmd args)))
+
+
;;; Library
;;
"Emus audio library.")
(defun emus-make-track (artist album title filename &optional pos)
+ "Create an object representing an emus track.
+ARTIST, ALBUM and TITLE are used to describe the track, FILENAME
+refers to the mp3 file containing the track. If non-nil, POS
+specifies the position of the record representing this track in the
+emus browser buffer."
(vector artist album title filename pos))
(defun emus-track-artist (track)
+ "The artist corresponding to TRACK."
(elt track 0))
(defun emus-track-album (track)
+ "The album corresponding to TRACK."
(elt track 1))
(defun emus-track-title (track)
+ "The title of TRACK."
(elt track 2))
(defun emus-track-file (track)
+ "The mp3 file corresponding to TRACK."
(elt track 3))
(defun emus-track-browser-pos (track)
+ "The location of the browser buffer record corresponding to TRACK."
(elt track 4))
(defun emus-set-track-browser-pos (track pos)
+ "Set the location of the browser buffer record corresponding to TRACK to POS."
(aset track 4 pos))
(defun emus--load-library (then)
- (emus--suspend-cp)
- (setq emus-state 'stopped)
- (let ((proc (emus-get-process))
- (tagstr "")
- (filenames (emus-get-audio-files)))
- (setq emus-tracks nil)
- (set-process-filter proc (lambda (proc string)
- (setq tagstr (concat tagstr string))
- (when (string-suffix-p "@P 1\n" string)
- (add-to-list 'emus-tracks
- (emus--make-track-from-tagstr (car filenames)
- tagstr))
- (setq tagstr "")
- (setq filenames (cdr filenames))
- (if filenames
- (emus-send-cmd "lp" (car filenames))
- (set-process-filter proc nil)
- (setq emus-tracks (reverse emus-tracks))
- (emus--sort-tracks)
- (unless emus-current-track
- (setq emus-current-track (car emus-tracks)))
- (funcall then)
- ;; (emus-render-tracks)
- (emus--resume-cp)))))
- (emus-send-cmd "lp" (car filenames))))
+ "Initialize the emus track library.
+Once the library is initialized, the function THEN is called."
+ (unless emus--proc-in-use
+ (setq emus--proc-in-use t)
+ (emus--suspend-cp)
+ (setq emus-state 'stopped)
+ (let ((proc (emus-get-process))
+ (tagstr "")
+ (filenames (emus-get-audio-files)))
+ (setq emus-tracks nil)
+ (set-process-filter proc (lambda (proc string)
+ (setq tagstr (concat tagstr string))
+ (when (string-suffix-p "@P 1\n" string)
+ (add-to-list 'emus-tracks
+ (emus--make-track-from-tagstr (car filenames)
+ tagstr))
+ (setq tagstr "")
+ (setq filenames (cdr filenames))
+ (if filenames
+ (emus--send-cmd-raw "lp" (car filenames))
+ (set-process-filter proc nil)
+ (setq emus-tracks (reverse emus-tracks))
+ (emus--sort-tracks)
+ (unless emus-current-track
+ (setq emus-current-track (car emus-tracks)))
+ (funcall then)
+ (emus--resume-cp)
+ (setq emus--proc-in-use nil)))))
+ (emus--send-cmd-raw "lp" (car filenames)))))
(defun emus--make-track-from-tagstr (filename tagstr)
+ "Parse TAGSTR to populate the fields of a track corresponding to FILENAME."
(let ((artist "")
(album "")
(title ""))
(emus-make-track artist album title filename nil)))
(defun emus--sort-tracks ()
+ "Sort the library tracks according to artist and album.
+Leaves the track titles unsorted, so they will appear in the order specified
+by the filesystem."
(sort emus-tracks
(lambda (r1 r2)
(let ((artist1 (emus-track-artist r1))
(string< album1 album2))
(string< artist1 artist2))))))
-(defmacro emus--with-library (&rest args)
+(defmacro emus--with-library (&rest body)
+ "Evaluate BODY with the library initialized."
`(if emus-tracks
- (progn ,@args)
+ (progn ,@body)
(emus--load-library
- (lambda () ,@args))))
-
-;;; mpg123 process
-;;
-
-(defvar emus-proc-in-use nil)
-
-(defun emus-get-process ()
- "Return current or new mpg123 process."
- (let* ((emus-process-raw (get-process "emus-process"))
- (emus-process (if emus-process-raw
- (if (process-live-p emus-process-raw)
- emus-process-raw
- (kill-process emus-process-raw)
- nil))))
- (if emus-process
- emus-process
- (let ((proc
- (make-process :name "emus-process"
- ;; :buffer (get-buffer-create "*emus-process*")
- :command `(,emus-mpg123-program "-R"))))
- (set-process-query-on-exit-flag proc nil)
- (process-send-string proc "silence\n")
- proc))))
-
-
-(defun emus-send-cmd (cmd &rest args)
- (process-send-string (emus-get-process)
- (concat
- (seq-reduce (lambda (s1 s2) (concat s1 " " s2)) args cmd)
- "\n")))
-
-(defun emus-send-and-process (respfun predfun cmd &rest args)
- (let ((respstr ""))
- (set-process-filter (emus-get-process)
- (lambda (proc string)
- (setq respstr (concat respstr string))
- (when (funcall predfun respstr)
- (set-process-filter proc nil)
- (funcall respfun respstr))))
- (apply #'emus-send-cmd cmd args)))
+ (lambda () ,@body))))
;;; Playback
(defvar emus-continuous-playback t)
(defun emus--suspend-cp ()
+ "Suspend continuous playback."
(setq emus-continuous-playback nil))
(defun emus--resume-cp ()
+ "Resume continuous playback."
(setq emus-continuous-playback t)
(set-process-filter (emus-get-process)
- (lambda (proc string)
+ (lambda (_proc string)
(and emus-continuous-playback
(eq emus-state 'playing)
(string-suffix-p "@P 0\n" string)
(emus-send-cmd "s")))
(defun emus-playpause ()
+ "Begin playback of the current track.
+If the track is already playing, pause playback.
+If the track is currently paused, resume playback."
(interactive)
(emus--with-library
(when emus-current-track
(unless (eq emus-state 'paused)))
(emus--update-track emus-current-track))))
-(defvar emus-current-volume 100)
+(defvar emus-current-volume 100
+ "The current playback volume.")
(defun emus-set-volume (pct)
+ "Set the playback volume to PCT %."
(emus--with-library
(setq emus-current-volume pct)
(emus-send-cmd "v" (number-to-string pct))))
(defun emus-volume-increase-by (delta)
+ "Increase the playback volume by DELTA %."
(emus-set-volume (max 0 (min 100 (+ emus-current-volume delta)))))
(defun emus-volume-up ()
+ "Increase the playback volume by 10%."
(interactive)
(emus-volume-increase-by 10))
(defun emus-volume-down ()
+ "Decrease the playback volume by 10%."
(interactive)
(emus-volume-increase-by -10))
(defun emus--play-adjacent-track (&optional prev)
+ "Play the next track in the library, or the previous if PREV is non-nil."
(emus--with-library
(let ((idx (seq-position emus-tracks emus-current-track))
(offset (if prev -1 +1)))
(error "No track selected")))))
(defun emus--play-adjacent-album (&optional prev)
+ "Play the first track of the next album in the library.
+If PREV is non-nil, plays the last track of the previous album."
(emus--with-library
(let ((idx (seq-position emus-tracks emus-current-track)))
(if idx
(error "No track selected")))))
(defun emus-play-next ()
+ "Play the next track in the library."
(interactive)
(emus--play-adjacent-track))
(defun emus-play-prev ()
+ "Play the previous track in the library."
(interactive)
(emus--play-adjacent-track t))
(defun emus-play-next-album ()
+ "Play the first track of the next album in the library."
(interactive)
(emus--play-adjacent-album))
(defun emus-play-prev-album ()
+ "Play the last track of the previous album in the library."
(interactive)
(emus--play-adjacent-album t))
(emus-jump -10))
(defun emus-display-status ()
+ "Display the current playback status in the minibuffer."
(interactive)
(emus--with-library
(message
(defun emus-centre-current ()
(interactive)
(when (get-buffer "*emus*")
- (switch-to-buffer "*emus*")
(when emus-current-track
(goto-char (emus-track-browser-pos emus-current-track))
(recenter))))