https://github.com/cheshire137/huxleyfm
An unofficial desktop app for listening to SomaFM, built with Electron.
https://github.com/cheshire137/huxleyfm
desktop-app electron javascript music nodejs radio somafm
Last synced: 7 months ago
JSON representation
An unofficial desktop app for listening to SomaFM, built with Electron.
- Host: GitHub
- URL: https://github.com/cheshire137/huxleyfm
- Owner: cheshire137
- License: mit
- Created: 2016-05-18T03:13:55.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2019-11-05T02:28:34.000Z (almost 6 years ago)
- Last Synced: 2025-04-08T02:35:17.417Z (7 months ago)
- Topics: desktop-app, electron, javascript, music, nodejs, radio, somafm
- Language: JavaScript
- Homepage:
- Size: 1.87 MB
- Stars: 23
- Watchers: 7
- Forks: 3
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
#  HuxleyFM
[](https://travis-ci.org/cheshire137/huxleyfm)
A desktop player for [SomaFM](http://somafm.com/). Compare to my [Chrome extension](https://github.com/cheshire137/soma-chrome) for listening to SomaFM.
**[Download](https://github.com/cheshire137/huxleyfm/releases)**
See also the [change log](CHANGELOG.md).
## How to Develop
npm install
This will install necessary packages as well as create config.json for you to modify.
If you want to be able to scrobble songs to your Last.fm account, you will need to configure config.json with [your Last.fm API key and secret](http://www.last.fm/api/account/create).
Specify `user_agent` in config.json to something custom for your app. The user agent is sent in request headers to Last.fm and the Soma API.
Specify `new_bug_report_url` to the URL where users should report a new bug with the app.
npm start
### Ubuntu 14.04 Instructions
Install nodejs 6+ via instructions on [nodejs.org](https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions)
curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
sudo apt-get install -y build-essential libavahi-compat-libdnssd-dev nodejs
### Environment Variables
Pass `NODE_ENV=development` to view the JavaScript console for debugging, e.g., `NODE_ENV=development npm start`.
Pass `DISABLE_PLAYING=1` to disable actually playing music when a station is selected.
### Troubleshooting
If you run into an error about a module version mismatch, try running `npm version`. My output looks like:
```
% npm version
{ huxleyfm: '0.0.1',
npm: '3.9.3',
ares: '1.10.1-DEV',
http_parser: '2.7.0',
icu: '57.1',
modules: '48',
node: '6.2.0',
openssl: '1.0.2h',
uv: '1.9.1',
v8: '5.0.71.47',
zlib: '1.2.8' }
```
If your `modules` is not 48, upgrade node. In OS X if you installed via Homebrew:
brew update
brew upgrade node
npm install -g npm
After upgrading node:
npm install -g node-gyp
cd node_modules/mdns
node-gyp BUILDTYPE=Release rebuild
If you hit errors installing `castv2-client`, try running `npm install castv2-client --no-optional`.
### How to Build
[Travis](https://travis-ci.org/) is set up to build Linux, Mac, and Windows
versions on every tag. If you want to build manually on your computer, first
follow the 'How to Develop' steps above, then:
npm run build
Builds the app for OS X using [electron-packager](https://github.com/electron-userland/electron-packager).
npm run-script build-windows
Builds the app for Windows.
npm run-script build-linux
Builds the app for Linux.
You can use `node scripts/bump-version.js` to increment the app version in
package.json, commit that change and push it, make a git tag of the same name,
and push tags.
## License
MIT © [Sarah Vessels](http://3till7.net)