-;;; gnus-sound.el --- Sound effects for Gnus
-;; Copyright (C) 1996 Free Software Foundation
+;;; gnus-audio.el --- Sound effects for Gnus
+;; Copyright (C) 1996, 2000 Free Software Foundation
;; Author: Steven L. Baur <steve@miranova.com>
-;; Keywords: news
+;; Keywords: news, mail, multimedia
;; This file is part of GNU Emacs.
;; Boston, MA 02111-1307, USA.
;;; Commentary:
+
;; This file provides access to sound effects in Gnus.
-;; Prerelease: This file is partially stripped to support earcons.el
-;; You can safely ignore most of it until Red Gnus. **Evil Laugh**
-;;; Code:
+;; This file is partially stripped to support earcons.el.
-(if (null (boundp 'running-xemacs))
- (defvar running-xemacs (string-match "XEmacs\\|Lucid" emacs-version)))
+;;; Code:
(require 'nnheader)
-(eval-when-compile (require 'cl))
-
-(defvar gnus-sound-inline-sound
- (and (fboundp 'device-sound-enabled-p)
- (device-sound-enabled-p))
- "When t, we will not spawn a subprocess to play sounds.")
-
-(defvar gnus-sound-directory (nnheader-find-etc-directory "sounds")
- "The directory containing the Sound Files.")
-
-(defvar gnus-sound-au-player "/usr/bin/showaudio"
- "Executable program for playing sun AU format sound files")
-(defvar gnus-sound-wav-player "/usr/local/bin/play"
- "Executable program for playing WAV files")
-
-
-;;; The following isn't implemented yet. Wait for Red Gnus.
-;(defvar gnus-sound-effects-enabled t
-; "When t, Gnus will use sound effects.")
-;(defvar gnus-sound-enable-hooks nil
-; "Functions run when enabling sound effects.")
-;(defvar gnus-sound-disable-hooks nil
-; "Functions run when disabling sound effects.")
-;(defvar gnus-sound-theme-song nil
-; "Theme song for Gnus.")
-;(defvar gnus-sound-enter-group nil
-; "Sound effect played when selecting a group.")
-;(defvar gnus-sound-exit-group nil
-; "Sound effect played when exiting a group.")
-;(defvar gnus-sound-score-group nil
-; "Sound effect played when scoring a group.")
-;(defvar gnus-sound-busy-sound nil
-; "Sound effect played when going into a ... sequence.")
+
+(defgroup gnus-audio nil
+ "Playing sound in Gnus."
+ :version "21.1"
+ :group 'gnus-visual
+ :group 'multimedia)
+
+(defvar gnus-audio-inline-sound
+ (or (if (fboundp 'device-sound-enabled-p)
+ (device-sound-enabled-p)) ; XEmacs
+ (fboundp 'play-sound)) ; Emacs 21
+ "Non-nil means try to play sounds without using an external program.")
+
+(defcustom gnus-audio-directory (nnheader-find-etc-directory "sounds")
+ "The directory containing the Sound Files."
+ :type '(choice directory (const nil))
+ :group 'gnus-audio)
+
+(defcustom gnus-audio-au-player (executable-find "play")
+ "Executable program for playing sun AU format sound files."
+ :group 'gnus-audio
+ :type 'string)
+
+(defcustom gnus-audio-wav-player (executable-find "play")
+ "Executable program for playing WAV files."
+ :group 'gnus-audio
+ :type 'string)
+
+;;; The following isn't implemented yet. Wait for Millennium Gnus.
+;;(defvar gnus-audio-effects-enabled t
+;; "When t, Gnus will use sound effects.")
+;;(defvar gnus-audio-enable-hooks nil
+;; "Functions run when enabling sound effects.")
+;;(defvar gnus-audio-disable-hooks nil
+;; "Functions run when disabling sound effects.")
+;;(defvar gnus-audio-theme-song nil
+;; "Theme song for Gnus.")
+;;(defvar gnus-audio-enter-group nil
+;; "Sound effect played when selecting a group.")
+;;(defvar gnus-audio-exit-group nil
+;; "Sound effect played when exiting a group.")
+;;(defvar gnus-audio-score-group nil
+;; "Sound effect played when scoring a group.")
+;;(defvar gnus-audio-busy-sound nil
+;; "Sound effect played when going into a ... sequence.")
;;;###autoload
-;(defun gnus-sound-enable-sound ()
-; "Enable Sound Effects for Gnus."
-; (interactive)
-; (setq gnus-sound-effects-enabled t)
-; (run-hooks gnus-sound-enable-hooks))
+;;(defun gnus-audio-enable-sound ()
+;; "Enable Sound Effects for Gnus."
+;; (interactive)
+;; (setq gnus-audio-effects-enabled t)
+;; (gnus-run-hooks gnus-audio-enable-hooks))
;;;###autoload
-;(defun gnus-sound-disable-sound ()
-; "Disable Sound Effects for Gnus."
-; (interactive)
-; (setq gnus-sound-effects-enabled nil)
-; (run-hooks gnus-sound-disable-hooks))
+ ;(defun gnus-audio-disable-sound ()
+;; "Disable Sound Effects for Gnus."
+;; (interactive)
+;; (setq gnus-audio-effects-enabled nil)
+;; (gnus-run-hooks gnus-audio-disable-hooks))
;;;###autoload
-(defun gnus-sound-play (file)
- "Play a sound through the speaker."
- (interactive)
+(defun gnus-audio-play (file)
+ "Play a sound FILE through the speaker."
+ (interactive "fSound file name: ")
(let ((sound-file (if (file-exists-p file)
file
- (concat gnus-sound-directory file))))
+ (expand-file-name file gnus-audio-directory))))
(when (file-exists-p sound-file)
- (if gnus-sound-inline-sound
- (play-sound-file (concat gnus-sound-directory sound-file))
- (cond ((string-match "\\.wav$" sound-file)
- (call-process gnus-sound-wav-player
- (concat gnus-sound-directory sound-file)
- 0
- nil))
- ((string-match "\\.au$" sound-file)
- (call-process gnus-sound-au-player
- (concat gnus-sound-directory sound-file)
- 0
- nil)))))))
+ (cond ((and gnus-audio-inline-sound
+ (condition-case nil
+ ;; Even if we have audio, we may fail with the
+ ;; wrong sort of sound file.
+ (progn (play-sound-file sound-file)
+ t)
+ (error nil))))
+ ;; If we don't have built-in sound, or playing it failed,
+ ;; try with external program.
+ ((equal "wav" (file-name-extension sound-file))
+ (call-process gnus-audio-wav-player
+ sound-file
+ 0
+ nil
+ sound-file))
+ ((equal "au" (file-name-extension sound-file))
+ (call-process gnus-audio-au-player
+ sound-file
+ 0
+ nil
+ sound-file))))))
;;; The following isn't implemented yet, wait for Red Gnus
-;(defun gnus-sound-startrek-sounds ()
-; "Enable sounds from Star Trek the original series."
-; (interactive)
-; (setq gnus-sound-busy-sound "working.au")
-; (setq gnus-sound-enter-group "bulkhead_door.au")
-; (setq gnus-sound-exit-group "bulkhead_door.au")
-; (setq gnus-sound-score-group "ST_laser.au")
-; (setq gnus-sound-theme-song "startrek.au")
-; (add-hook 'gnus-select-group-hook 'gnus-sound-startrek-select-group)
-; (add-hook 'gnus-exit-group-hook 'gnus-sound-startrek-exit-group))
+;;(defun gnus-audio-startrek-sounds ()
+;; "Enable sounds from Star Trek the original series."
+;; (interactive)
+;; (setq gnus-audio-busy-sound "working.au")
+;; (setq gnus-audio-enter-group "bulkhead_door.au")
+;; (setq gnus-audio-exit-group "bulkhead_door.au")
+;; (setq gnus-audio-score-group "ST_laser.au")
+;; (setq gnus-audio-theme-song "startrek.au")
+;; (add-hook 'gnus-select-group-hook 'gnus-audio-startrek-select-group)
+;; (add-hook 'gnus-exit-group-hook 'gnus-audio-startrek-exit-group))
;;;***
-(provide 'gnus-sound)
+(defvar gnus-startup-jingle "Tuxedomoon.Jingle4.au"
+ "Name of the Gnus startup jingle file.")
+
+(defun gnus-play-jingle ()
+ "Play the Gnus startup jingle, unless that's inhibited."
+ (interactive)
+ (gnus-audio-play gnus-startup-jingle))
+
+(provide 'gnus-audio)
-(run-hooks 'gnus-sound-load-hook)
+(run-hooks 'gnus-audio-load-hook)
-;;; gnus-sound.el ends here
+;;; gnus-audio.el ends here
projects / gnus / blobdiff