README.md

local-music-player-firefox

Firefox addon allowing user to listen to music stored on their local system.

Features

• Add and remove music directories to library (stored across sessions)
• Optional, recursive directory scan
• Play, pause, previous, stop, next buttons
• Seek/skip
• Play single song (disable single, all and randomize buttons)
• Repeat single song
• Repeat all songs sequentially (default)
• Randomize
• Displays currently playing song
• Volume adjustment controls
• Mute/unmute button
• Optional, notification on song start
• Filter songs using search textfield
• Share current song via Twitter, Tumblr
• Default hotkeys provided (+user configurable)
• Optional, toolbar with various buttons and current track label

Audio support

Addon uses HTML5 <audio> element, which includes support for:

• .mp3
• .mp4 *
• .wav
• .ogg

* "Firefox supports the format in some cases, but only when a third-party decoder is available, and the device hardware can handle the profile used to encode the MP4." reference

More info here on audio support within Firefox.

Default hotkeys

• accel-shift-p .. Play track
• accel-shift-s .. Stop track
• accel-shift-right .. Next song
• accel-shift-left .. Previous song
• accel-shift-r .. Randomize
• accel-shift-1 .. Repeat single song
• accel-shift-a .. Repeat all songs

Locale support

• bg
• cs-CZ
• de-DE
• en-GB
• en-US
• es-ES
• fr-FR
• it-IT
• ja-JP
• ko-KR
• pl-PL
• pt-PT
• ru-RU
• sv-SE
• uk-UA
• zh-CN

Image attributions

• App icon, https://www.iconfinder.com/icons/175749/music_record_icon
• Control icons, http://icons4android.com

Development

npm install
grunt

Build

grunt build

Run

rob@work:~/git/local-music-player-firefox$ cd dist/
rob@work:~/git/local-music-player-firefox/dist$ ~/apps/addon-sdk-1.17/bin/cfx run

Package

rob@work:~/git/local-music-player-firefox/dist$ ~/apps/addon-sdk-1.17/bin/cfx xpi