Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 

readme.org

Emacs Party Mode

It’s an Emacs party and you’re invited. Checkout the video demo.

💖💕🎶 Thanks a million to CRAPFACE for letting me use a track from this awesome mix.

Installation

Vanilla Emacs

Clone this repository with e.g. $ git clone git@github.com:parkeristyping/party-mode.git.

Then, make sure the party-mode repo you just cloned is in your Emacs load path, and require the package. You can do this by adding these lines to your .emacs or .emacs.d/init.el file:

(add-to-list 'load-path "~/path/to/party-mode")
(require 'party-mode)

Spacemacs

I’m a big fan of Spacemacs, which uses “layers” for package setup and configuration. So, I created one that encapsulates my personal configuration of party-mode. Here it is if you’d like to take a look.

Usage

Party with M-x party-mode RET.

Get back to work with M-x stop-partying RET.

Music Configuration

You have to do a bit of configuration to get the music playback part working.

There are two variables that, if not nil, get called as functions when you start and stop party-mode. These are, respectively: party-mode-start-music-fn and party-mode-stop-music-fn.

They default to nil, but you can set them to whatever you want to play music. Below I describe two options I’ve been able to get working.

1. Use a shell command like afplay

Probably the easiest way to get party-mode working is using a shell command for music playback. This can be done out-of-the-box with newish Macs using the afplay command. The rest of this example uses afplay, but it should be pretty much the same for any command line music player.

First, find a song that you want to party to, and make sure afplay is working by trying out $ afplay /absolute/path/to/song.mp3 at the command line.

Once you confirm that’s working, the next step is to customize party-mode-start-music-fn in your .emacs (or .emacs.d/init.el, .spacemacs.d/init.el, etc):

(setq party-mode-start-music-fn
  (lambda () (start-process "party-music" "*party-music*" "afplay" "/absolute/path/to/song.mp3")))

Finally, you’ll also want to customize party-mode-stop-music-fn so the music cuts off when you’re done partying:

(setq party-mode-stop-music-fn
  (lambda () (kill-process "party-music")))

2. Use EMMS

Another option would be to use an Emacs media package like EMMS for music playback. To do that, you’ll first need to configure EMMS for audio playback. Once you’ve done that, you can customize party-mode-start-music-fn and party-mode-stop-music-fn using EMMS commands. Here’s an example, which streams some suggested party music:

(setq party-mode-start-music-fn
  (lambda () (emms-play-url "https://s3-us-west-2.amazonaws.com/partymode/party_music.mp3")))
(setq party-mode-stop-music-fn 'emms-pause)

License

MIT

About

Emacs party mode

Resources

License

Packages

No packages published