Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Turning your ARM device into AngelBox
Are you interested in our AngelBox? You can have one for free! We offer you a complete SD card image for Raspberry Pi 2/3 and Orange Pi Zero or you can also use our APT repository to install Arrow Client into an existing system.
Cloning SD card image
Before you continue, you will need the following:
- 2 GB micro SD card (or bigger),
- our AngelBox image.
Etcher is a multi-platform tool for cloning SD card images. You can download it from etcher.io. The AngelBox image can be downloaded from here. All Raspberry Pi images are named
angel-box-rpi-*.img.zip and all Orange Pi Zero images are named
angel-box-opi-*.img.zip. To clone the SD card image, follow these simple steps:
- Open Etcher.
- Select the AngelBox image.
- Plug in your SD card.
- Select the device with your SD card (unless it's already selected).
- Click on the "Flash!" button and wait until the image is written.
- Unplug the SD card.
Post installation setup
Plug the SD card into your device.
Connect the device to your local network using an ethernet cable.
Power on the device.
Connect your workstation to the same local network.
Find IP address of your device in the list of DHCP clients of your router OR change IP address of your workstation to 192.168.123.1 and mask to 255.255.255.0.
Connect to the device using SSH (username: pi, password: arrow, address: 192.168.123.123 or the address assigned by DHCP).
- In Windows, you can use PuTTY.
- In OS X or Linux, open terminal and enter
Get MAC address of your device and write it down somewhere:
Raspberry Pi only: Expand the root filesystem to the whole SD card:
- Select "Advanced Options".
- Select "Expand Filesystem".
- Confirm device reboot.
Orange Pi Zero only: Expand the root filesystem to the whole SD card:
sudo /etc/init.d/resize2fs start sudo reboot
Installation from our APT repository
For using the deb packages from our repository, you will need a running Debian Stretch based distribution on an ARM device, e.g. Raspbian Stretch on Raspberry Pi. Log in to your device (either directly or using SSH) and enter the following commands into the terminal:
sudo apt-get update sudo apt-get install dirmngr sudo apt-key adv --keyserver hkp://keys.gnupg.net --recv-keys 7FBFBC65 sudo sh -c 'echo "deb http://apt.angelcam.com/raspbian-stretch stable main" > /etc/apt/sources.list.d/arrow.list' sudo apt-get update sudo apt-get install arrow-box
The arrow-box service gets started automatically after installation of the package. If you need to start/stop it manually, you can use standard systemd commands:
sudo systemctl start arrow-box.service sudo systemctl stop arrow-box.service
All logs go into syslog. If you need to modify the arrow-client startup parameters, you can modify them in the
/etc/default/arrow-box file. To list all available parameters, run the following command:
Optionally you can also install the
arrow-box-utils package. The package contains a cron job that will keep your client up to date and there is also a service that can use one of the RPi LEDs as an Arrow Client connection status indicator. To install the additional package, enter the following command:
sudo apt-get install arrow-box-utils
To enable the connection status indicator:
sudo systemctl enable arrow-box-led.service sudo systemctl start arrow-box-led.service
Connecting to Angelcam
Congratulations! Your AngelBox is ready to roll! Now, the only thing you will need to connect to Angelcam is an IP camera with support of H.264 over RTSP or MJPEG. Connect the camera to the same local network as your AngelBox, go to my.angelcam.com/connect/diy-angelbox and enter the MAC address of your AngelBox.