RTLSDR-Airband - GitLite

KO | EN

gitlite — search

#javascript #typescript #llm #go #golang #rust #deep-learning #linux #macos #awesome #cli #awesome-list #security #ios

RTLSDR-Airband

(★ 126)

RTLSDR AM demodulator, support multiple channels per dongle, intended for x86 and Raspberry Pi

File Explorer

Download Latest Version (.zip)

- template.txt
- - .gitignore
- - .gitignore
- - .gitignore
- RTLSDR-Airband.sln
- RTLSDR-Airband.vcxproj
.gitignore
config.txt.example
demo.png
LICENSE
LICENSE.GPL2
makefile
README.md
rtl_airband.cpp
rtl_airband_asm.s

# Installation Guide

1. Get the code

git clone https://github.com/microtony/RTLSDR-Airband

Downloads the entire project code from GitHub to your computer.

cd RTLSDR-Airband

Moves into the project folder you just downloaded.

2. .NET

Medium Recommended

Prerequisites

Git Needed to download the project code from GitHub.
.NET SDK The SDK required for the dotnet command.

cd win32

This project's files live in a subfolder, so move into it first.

dotnet restore

Downloads the packages the project depends on.

dotnet run

Builds the project and runs it immediately.

✅ After dotnet run, check the message or address shown in the terminal.

3. Make

Medium

Prerequisites

Git Needed to download the project code from GitHub.
Make Usually pre-installed on Linux/macOS. On Windows, install separately (e.g. via MSYS2 or WSL).

make

Compiles the code based on the generated build configuration to produce an executable.

✅ If it finishes without errors, it worked. Try running the generated executable directly.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

RTLSDR-Airband
=====================

RTLSDR Airband is intended for Airband reception and online streaming to services such as liveatc.net

<b color="red">Very Important: 
This origin is not actively maintained. ![szpajder's fork](https://github.com/szpajder/RTLSDR-Airband) is recommended (and required for Raspberry Pi 2)</b>

Features
---------------------
 * Decode up to eight AM channels per dongle (within bandwidth frequency range)
 * Decode multiple dongles simutaneously
 * Auto squelch and Automatic Gain Control
 * MP3 encoding
 * Stream to Icecast or SHOUTcast server
 
Performance
---------------------
### Windows
 * ~4% per dongle on i5-2430m at 2.1 GHz
 
### Raspberry Pi 
 * FFT using Broadcom Videocore IV GPU
 * No overclock required when using 1 dongle plus another dongle running dump1090
 * Turbo overclock setting recommended when using 2 dongles

Demo
---------------------
![Demo (Windows version)](https://raw.githubusercontent.com/microtony/RTLSDR-Airband/master/demo.png)

Windows Binary
---------------------
* Requires CPU with SSE3 support.
* Requires [Visual C++ 2013 vcredist_x86.exe](http://www.microsoft.com/en-us/download/details.aspx?id=40784)
* [Download (build 2014-08-11)](http://www.microtony.com/rtl_airband_20140811.zip)

Building
---------------------
### Windows using VS Express 2013 for Desktop
#### Getting/Building prerequisites
##### FFTW3
 * Download fftw-3.3.4-dll32.zip from http://www.fftw.org/install/windows.html
 * Start the VS2013 x86 Native Tools Command Prompt
 * Run lib /def:libfftw3f-3.def to get libfftw3f-3.lib
 * Place the lib into win32/lib
 * Place fftw3.h into win32/include
 * Place libfftw3f-3.dll into the root folder
 
##### libogg and libvorbis
 * Download libogg-1.3.1.zip and libvorbis-1.3.4.zip from http://www.xiph.org/downloads/
 * Extract both zip files in the same folder
 * Rename libogg-1.x.x to libogg
 * Open libogg/win32/libogg_static.sln
 * Change to "Release" and build libogg_static
 * Open libvorbis-1.x.x/win32/VS2010/vorbis_static.sln
 * Change to "Release" and build libvorbis_static **(NOT the highlighted libvorbisfile)**
 * Copy both the generated .libs to win32/lib
 * Copy libogg/includes/ogg (the folder) to win32/include
 * Copy libvorbis-1.x.x/includes/vorbis (the folder) to win32/include
 
##### libmp3lame
 * Download from http://sourceforge.net/projects/lame/files/lame/3.99/
 * Open vc_solution/vc9_lame.sln
 * Change the Configuration to ReleaseSSE2
 * (optional) Right click libmp3lame-static and open Properties... C/C++... Code Generation... Enable Enhanced Instruction Set... Advanced Vector Instructions
 * Build libmp3lame-static
 * Copy output/ReleaseSSE2/libmp3lame-static.lib and libmpghip-static.lib to win32/lib
 * Copy include/lame.h to win32/include
 
##### librtlsdr
 * Download from http://sdr.osmocom.org/trac/wiki/rtl-sdr (search word: "pre-built")
 * Copy rtl-sdr-release/rtl-sdr.h and rtl-sdr_export.h to win32/includes
 * Copy rtl-sdr-release/x32/rtlsdr.lib to win32/lib
 * Copy rtl-sdr-release/x32/rtlsdr.dll and libusb-1.0.dll to root folder
 
##### pthreads
 * Download from ftp://sourceware.org/pub/pthreads-win32/
 * Extract Pre-built.2 to the same folder where libogg and libvorbis are located
 * Copy Pre-built.2/lib/x86/pthreadVCE2.lib to win32/lib
 * Copy Pre-built.2/dll/x86/pthreadVCE2.dll to root folder

##### libshout
 * This is the most complicated one
 * Download from http://www.icecast.org/download.php
 * Extract libshout to the same folder where libogg and libvorbis are located
 * Go to libshout-2.x.x/include/shout and rename shout.h.in to shout.h
 * Open libshout/win32/libshout.dsw
 * Change to "Release"... and then open project properties
 * On the General page change Character Set to Use Unicode Character Set
 * Go to C/C++... edit Additional Include Directories
 * Add ../../libogg/include, ../../libvorbis-1.x.x/include and ../../Pre-built.2/include
 * Go to C/C++... Preprocessor... edit Preprocessor Definitions
 * Add HAVE_SYS_TIMEB_H and HAVE_FTIME
 * Try to build, you should get errors
 * One of the error is "error C1083: Cannot open include file: 'compat.h': No such file or directory"
 * Double click on it and change that line from #include &lt;compat.h&gt; to #include &lt;os.h&gt;
 * Build again
 * Copy win32/Release/libshout.lib to win32/lib
 * Copy include/shout (the folder) to win32/include
 
#### Building this project
 * Browse into win32 and open the solution
 * Simply build solution or click the "Start Local Windows Debugger" button
 
### Raspberry Pi (Raspbian)
 * I assume you already have RTLSDR library installed: http://www.hamradioscience.com/raspberry-pi-as-remote-server-for-rtl2832u-sdr/
 * sudo apt-get install libmp3lame-dev libvorbis-dev libshout-dev libfftw3-dev
 * sudo rpi-update && sudo reboot
 * cd into the project folder (where makefile is located)
 * cp -r /opt/vc/src/hello_pi/hello_fft .
 * sudo mknod char_dev c 100 0
 * make
 * You need to run the program with sudo

Configuring
--------------------
All configurations are saved in config.txt file. Fields should be separated by space(s) or tab(s).

You may edit config.txt.example using a spreadsheet program.

Format:

NumDongles
    DongleNo NumChannels Gain CenterFreq FreqCorrection
    Hostname Port MountPoint Frequency Username Password
    Hostname Port MountPoint Frequency Username Password
    ....
    DongleNo NumChannels Gain CenterFreq FreqCorrection
    Hostname Port MountPoint Frequency Username Password
    .....

License
--------------------
Copyright (C) 2014 Wong Man Hang <microtony@gmail.com>

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
    
Open Source Licenses
---------------------

###fftw3
 * Copyright (c) 2003, 2007-14 Matteo Frigo
 * Copyright (c) 2003, 2007-14 Massachusetts Institute of Technology
 * GNU General Public License Version 2

###gpu_fft
Copyright (c) 2013, Andrew Holme.
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
* Neither the name of the copyright holder nor the
names of its contributors may be used to endorse or promote products
derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    
###libmp3lame
 *      Copyright (c) 1999 Mark Taylor
 *      Copyright (c) 2000-2002 Takehiro Tominaga
 *      Copyright (c) 2000-2011 Robert Hegemann
 *      Copyright (c) 2001 Gabriel Bouvigne
 *      Copyright (c) 2001 John Dahlstrom
 *  GNU Library General Public License Version 2

###libogg
Copyright (c) 2002, Xiph.org Foundation

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:

- Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.

- Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.

- Neither the name of the Xiph.org Foundation nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION
OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

###librtlsdr
 * Copyright (C) 2012 by Steve Markgraf <steve@steve-m.de>
 * GNU General Public License Version 2

###libshout
 * Copyright (C) 2002-2004 the Icecast team <team@icecast.org>
 * GNU Library General Public License Version 2

###libvorbis
Copyright (c) 2002-2008 Xiph.org Foundation

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:

- Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.

- Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.

- Neither the name of the Xiph.org Foundation nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION
OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.