KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #codex #ai-agents #claude-code #dsh #dsh-plugin #cli #macos #ai-agent #deepseek-harness #open-source

huxleyfm

★ 22 Open GitHub ↗

An unofficial desktop app for listening to SomaFM, built with Electron.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ![logo](https://raw.githubusercontent.com/cheshire137/huxleyfm/master/images/icon48.png) HuxleyFM

[![Build status](https://travis-ci.org/cheshire137/huxleyfm.svg?branch=master)](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).

![Screenshot of OS X app](https://raw.githubusercontent.com/cheshire137/huxleyfm/master/screenshots/os-x.png)

![Screenshot of OS X notification](https://raw.githubusercontent.com/cheshire137/huxleyfm/master/screenshots/notification.png)

![Screenshot of Windows station menu](https://raw.githubusercontent.com/cheshire137/huxleyfm/master/screenshots/choose-station.png)

![Screenshot of Windows settings](https://raw.githubusercontent.com/cheshire137/huxleyfm/master/screenshots/settings.png)

## 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

huxleyfm

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README