# Installation

Kali Rolling 2.0 (Debian Based OS)

This may be slightly different for other Operating Systems

Installing RVM & Ruby 2.2.2

gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3

\curl -sSL https://get.rvm.io | bash

source /etc/profile.d/rvm.sh
echo "source /etc/profile.d/rvm.sh" >> ~/.bashrc
sudo apt-get install dirmgr # needed in latest Kali for some reason
rvm install 2.2.2

Installing LiquidDSP (needed by Inspectrum)

git clone https://github.com/jgaeddert/liquid-dsp
cd liquid-dsp
./bootstrap.sh     # <- only if you cloned the Git repo
./configure
make
sudo make install
cd ../

Installing Inspectrum (instructions from: https://github.com/miek/inspectrum/wiki/Build)

git clone https://github.com/miek/inspectrum.git
cd inspectrum
sudo apt-get install qt5-default libfftw3-dev cmake pkg-config
mkdir build
cd build
cmake ..
make
sudo make install
cd ../../

Installing DSpectrumGUI (this app)

git clone https://github.com/tresacton/dspectrumgui.git
cd dspectrumgui
rvm use 2.2.2
gem install bundler
bundle config build.nokogiri --use-system-libraries
bundle
# there's a chance you'll have to run "gem install nokogiri -v 'x.x.x.x' " if bundler fails to do it for you
rake db:setup && rake db:migrate && rake db:seed

---

MAC OSX

This assumes you have cmake (probably need xcode to be installed)

Installing RVM & Ruby 2.2.2

gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
\curl -sSL https://get.rvm.io | bash

rvm install 2.2.2

Installing Inspectrum (instructions from: https://github.com/miek/inspectrum/wiki/Build)

Using Macports (homebrew is possible, but this is significantly easier because of cmake paths etc)

git clone https://github.com/miek/inspectrum.git
cd inspectrum
sudo port install qt5 fftw-3-single cmake pkgconfig liquid-dsp
mkdir build
cd build
cmake ..
make
sudo make install
cd ../../

Using Homebrew (not recommended for beginners - go the Macports route instead)

git clone https://github.com/miek/inspectrum.git
cd inspectrum
brew install qt5 fftw cmake pkg-config liquid-dsp
mkdir build
cd build
CMAKE_PREFIX_PATH=$(brew --prefix qt5)/lib/cmake cmake .. -DCMAKE_CXX_FLAGS:STRING=-I/usr/local/opt/qt5/include ..
make install
cd ../../

Installing DSpectrumGUI (this app)

git clone https://github.com/tresacton/dspectrumgui.git
cd dspectrumgui
rvm use 2.2.2
gem install bundler
bundle config build.nokogiri --use-system-libraries
bundle
rake db:setup && rake db:migrate && rake db:seed

---

Launching DSpectrumGUI

rails s -p 3001

You can now open a browser and navigate to http://localhost:3001/

---

Credentials

Username: user@example.com

Password: password

To change the credentials (recommended!):

cd dspectrumgui
rails c
u = User.last
u.email = "you@somewhere.com"
u.password = u.password_confirmation = "YourSecurePassword"
u.full_name = "Earthling"
u.save!

---

Security Considerations

Despite being a security researcher, I have given zero thought to the security of this app. I will go over it from a security perspective later (then update this text), so keep that in mind.

Don't expose the app to the internet.

Don't keep the server running while you're not using it (i.e. do a [ctrl][c] in the window where you ran the "rails s -p xxxx" command).