The open source software provided by FaradayRF is primarily written in Python. Any language capable of interfacing with a serial port or TCP/IP socket could be used. However, we chose Python 2.7 due to its ease of learning and cross-platform capabilities.
Please note that no testing has been performed with Python 3 at this time. If you do, please consider helping us update!
The Hitchhiker's Guide To Python: Installing Python on Windows
Most distributions come with Python preinstalled, however if not please read the Python Documentation
Most OS X versions already contain a version of Python.
If you are using Debian 8 you will need to install pip. Otherwise you already have it with Python.
sudo apt-get install python-pip
- Follow The Hitchhiker's Guide to Installing Python on Max OS X
- XCode
- Homebrew
- Python 2.7
- Setuptools
- Pip
- Optional: Virtual Environments
A basic version of Git comes on OS X. Apple Git-50.3 was used to write this guide but consider upgrading it or installing the official Git for OS X.
Faraday software is available on the Python Package Index and can be installed from PyPI with pip. This makes installation a breeze if you do not want to contribute code back into our Github repository.
If you do want to help the project by contributing code back into our repository then please follow the Installing in Pip Editable Mode section.
Just want to run the latest faraday software? Open up a command prompt and execute the following commands:
pip install faraday
That's it!
If you want to be able to develop with faraday software then we suggest cloning our Git Repository as described below and install with pip in 'editable' mode. Please note that in 'editable' mode you may have to run faraday software from the root project directory due to filepath issues when running in this mode.
The open-source software is provided on our GitHub repository. This guide assumes Git is installed along with Git Bash.
Using Git Bash (right-click|Git Bash here) this example will be relative to wherever you start bash:
- Create a suitable folder for Faraday software. i.e.
mkdir -p git/faradayrf - Navigate to the new folder
cd git/faradayrf - Clone the lastest master branch
git clone https://github.com/FaradayRF/Faraday-Software.git software - Navigate to the software
cd software - Install in pip editable mode with
pip install -e .
Now you can use faraday the same as performing a pip install faraday however almost all changes to the code in your git clone will automatically be available from command line. Please note that changes to setuptools configuration in setup.cfg such as adding a new application command line option will require reinstalling in editable mode.
Consider forking our repository instead!
This guide assumes Git is installed.
- Create suitable folder for Faraday software. I.e.
mkdir -p git/faradayrf - Navigate to the new folder
cd git/faradayrf - Clone latest master branch
git clone https://github.com/FaradayRF/Faraday-Software.git software - Navigate to the software
cd software - Install in pip editable mode with
pip install -e .
Now you can use faraday the same as performing a pip install faraday however almost all changes to the code in your git clone will automatically be available from command line. Please note that changes to setuptools configuration in setup.cfg such as adding a new application command line option will require reinstalling in editable mode.
Consider forking our repository instead!
This guide assumes Git is installed. A basic and suitable Git is installed on all OS X computers but it is a stripped-down version.
- Create suitable folder for Faraday software. I.e.
mkdir -p git/faradayrf - Navigate to the new folder
cd git/faradayrf - Clone latest master branch
git clone https://github.com/FaradayRF/Faraday-Software.git software - Navigate to the software
cd software - Install in pip editable mode with
pip install -e .
Now you can use faraday the same as performing a pip install faraday however almost all changes to the code in your git clone will automatically be available from command line. Please note that changes to setuptools configuration in setup.cfg such as adding a new application command line option will require reinstalling in editable mode.
Consider forking our repository instead!
Congratulations! Making it this far means that you're so close to using Faraday. However we need to plug in the Faraday hardware and complete configuration before running the software.