Skip to content

Commit

Permalink
Update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
Dominic Mooney committed Oct 20, 2017
1 parent d859b9b commit f1f9c28
Show file tree
Hide file tree
Showing 4 changed files with 40 additions and 3 deletions.
1 change: 0 additions & 1 deletion CNAME

This file was deleted.

36 changes: 36 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,38 @@
# FM Radio Tuner

![Image of fmradio](screens/fmradio.png)

A simple cross-platform Electron app for listening to FM radio using an RTL2832U based USB dongle.

## Features:
- Tested on Windows 10 Windows 7, Ubuntu 16.04 and Fedora 24. Should work on MAC.
- Supports all tuners supported by [rtl-sdr](http://sdr.osmocom.org/trac/wiki/rtl-sdr)
- Stereo decoding.
- Good sound quality at higher sample rates (you be the judge).
- Plays audio locally and on local HTTP server for remote listening.
- Scan for stations.
- Add station presets.
- Record audio in lossless FLAC format.
- Fully configurable.
- Prebuilt for x64 Windows and Linux.

## Hardware Requirements
### Intel CPUs
- Dual core CPU (tested and runs on a 2008 Pentium dual core T4200 laptop).
- 1.5GB RAM.
- Max sample rate for Intel is usually 2.56Msps.
### ARM CPU
- Runs well on ASUS Tinkerboard. Tested using Armbian and TinkerOS. Max stable sample rate is 2.56Msps but will run at higher rates, if unreliably.
- Does not run on Raspberry Pi but should run on any SBC with enough RAM and CPU grunt.

## Building

### Linux
Requires librtlsdr-dev, libusb and libFLAC++-dev.
Install dependencies, clone the repo and run 'npm install', then 'npm start' from the cloned directory.

### Windows
Complicated and a little painful. Will document at some point.



6 changes: 4 additions & 2 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@
"start": "electron-forge start",
"package": "electron-forge package",
"make": "electron-forge make",
"publish": "electron-forge publish",
"lint": "eslint app/src --color"
},
"author": "Dominic Mooney",
Expand Down Expand Up @@ -60,6 +61,7 @@
"ignore": [
"build_scripts",
"dll_bundle",
"screens",
".vscode",
".npmrc"
],
Expand All @@ -78,8 +80,8 @@
"icon": "icons/tower.png"
},
"github_repository": {
"owner": "",
"name": ""
"owner": "dmooney65",
"name": "fmradio"
},
"windowsStoreConfig": {
"packageName": "fmradio"
Expand Down
Binary file added screens/fmradio.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit f1f9c28

Please sign in to comment.