# How to become a feeder?

# [PL] Zostań feederem ADS-B.Pro

# Konfiguracja ADS-B.Pro feeder

## 1. Co będzie potrzebne

- Raspberry Pi / Debian / Ubuntu z dostępem do internetu.
- Odbiornik RTL-SDR lub inny odbiornik ADS-B.
- Działający `dump1090-fa`, `dump1090-mutability`, `dump1090` albo `readsb`.
- Konto w ADS-B.Pro.
- Twój prywatny feeder token z konta użytkownika.

Token feeder jest unikalny. W panelu konta jest pokazywany jako **Your Feeder Token** i ma format:

```text
ADS-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

czyli `ADS-` plus 32 znaki hex. Skrypt wymaga małych liter `a-f`.

## 2. Skąd wziąć token

1. Zaloguj się w ADS-B.Pro.
2. Wejdź w **My Account**.
3. Skopiuj wartość z pola **Your Feeder Token**.
4. Nie publikuj tego tokena w logach, na GitHubie ani w screenach.

Frontend używa tego tokena tylko jako wartości przypisanej do konta. Sam feeder wysyła go do backendu przez osobny skrypt `/opt/radarview.py`.

## 3. Najprostsza instalacja feedera

Rekomenduję wariant `radarview_setup-nogit.sh`, bo nie wymaga klonowania repozytorium i sam pobiera aktualny `radarview.py`.

```bash
sudo apt update
sudo apt install -y curl wget ca-certificates

curl -fsSL https://raw.githubusercontent.com/br3jski/radarview/refs/heads/main/radarview_setup-nogit.sh -o radarview_setup-nogit.sh
chmod +x radarview_setup-nogit.sh

sudo ./radarview_setup-nogit.sh
```

Po uruchomieniu skrypt poprosi o token:

```text
Please enter your RadarView token (format: ADS-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX):
```

Wklej token z **My Account**.

## 4. Co robi skrypt

Skrypt:

1. Sprawdza, czy jest uruchomiony jako `root`.
2. Waliduje token użytkownika.
3. Sprawdza, czy istnieje lokalne źródło ADS-B:
   - `dump1090-fa`
   - `dump1090-mutability`
   - `dump1090`
   - `readsb`
4. Jeśli nie ma dump1090/readsb, pyta, czy zainstalować `dump1090-fa`.
5. Pobiera `radarview.py` do:

```text
/opt/radarview.py
```

6. Wstawia token do zmiennej:

```python
USER_TOKEN = 'ADS-...'
```

7. Tworzy usługę systemd:

```text
/etc/systemd/system/radarview.service
```

8. Uruchamia i włącza usługę na start systemu:

```bash
systemctl start radarview
systemctl enable radarview
```

## 5. Jak działa wysyłanie danych

`radarview.py` łączy się lokalnie z odbiornikiem ADS-B na porcie SBS:

```text
127.0.0.1:30003
```

Następnie wysyła dane do ADS-B.Pro:

```text
feed.ads-b.pro:48581
```

Przed każdą linią danych skrypt wysyła token:

```text
TOKEN:ADS-...
```

Dlatego kluczowe są dwie rzeczy:

- lokalny `dump1090` / `readsb` musi wystawiać dane SBS na `127.0.0.1:30003`,
- urządzenie musi mieć możliwość połączenia wychodzącego TCP do `feed.ads-b.pro:48581`.

## 6. Sprawdzenie po instalacji

Status usługi feedera:

```bash
sudo systemctl status radarview
```

Logi na żywo:

```bash
sudo journalctl -u radarview -f
```

Poprawne logi powinny zawierać coś w tym stylu:

```text
Connected to source 127.0.0.1:30003
Connected to destination feed.ads-b.pro:48581
Data sent with token
```

Sprawdzenie, czy lokalny ADS-B działa na porcie `30003`:

```bash
nc -vz 127.0.0.1 30003
```

Sprawdzenie połączenia do serwera ADS-B.Pro:

```bash
nc -vz feed.ads-b.pro 48581
```

## 7. Jeśli używasz readsb zamiast dump1090-fa

Upewnij się, że `readsb` ma włączony port SBS `30003`. Feeder z podanego skryptu nie czyta JSON-a ani Beast, tylko tekstowy strumień SBS/BaseStation z portu `30003`.

Przykładowo konfiguracja `readsb` powinna zawierać odpowiednik:

```text
--net
--net-sbs-port 30003
```

Po zmianach zrestartuj `readsb`.

## 8. Zmiana tokena po instalacji

Jeśli token został odnowiony albo wklejony błędnie, najprościej uruchomić skrypt instalacyjny ponownie.

Można też ręcznie poprawić `/opt/radarview.py`, znaleźć linię:

```python
USER_TOKEN = 'ADS-...'
```

i po zmianie zrestartować usługę:

```bash
sudo systemctl restart radarview
```

## 9. Typowe problemy

**Invalid token format**  
Token nie pasuje do formatu `ADS-` plus 32 znaki hex. Skopiuj token dokładnie z **My Account**.

**Error: User token not set**  
W `/opt/radarview.py` token jest pusty. Uruchom setup ponownie albo popraw `USER_TOKEN`.

**Socket error przy `127.0.0.1:30003`**  
`dump1090` / `readsb` nie działa albo nie wystawia SBS na porcie `30003`.

**Socket error przy `feed.ads-b.pro:48581`**  
Problem z DNS, internetem, firewallem albo blokadą połączeń wychodzących TCP na port `48581`.

**Konto nadal nie ma statusu Feeder**  
Feeder musi faktycznie wysyłać stabilne dane. Po stronie frontendu status `Feeder` pojawia się z konta użytkownika/backendu; czasem trzeba się wylogować i zalogować ponownie albo odświeżyć token sesji po zatwierdzeniu feedera.

# [EN] Become ADS-B.Pro Feeder!

# ADS-B.Pro Feeder Setup Guide

## 1. Requirements

You will need:

- Raspberry Pi / Debian / Ubuntu with internet access.
- RTL-SDR or another ADS-B receiver.
- Working `dump1090-fa`, `dump1090-mutability`, `dump1090`, or `readsb`.
- ADS-B.Pro account.
- Your private feeder token.

The feeder token is unique per account. In the account panel it is shown as **Your Feeder Token** and has this format:

```text
ADS-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

That means `ADS-` plus 32 hexadecimal characters. The setup script expects lowercase `a-f`.

## 2. Where To Find Your Token

1. Log in to ADS-B.Pro.
2. Open **My Account**.
3. Copy the value from **Your Feeder Token**.
4. Do not publish this token in logs, screenshots, GitHub issues, or config examples.

The frontend displays this token from your account data. The actual feeder sends it to the backend through `/opt/radarview.py`.

## 3. Recommended Installation

Use `radarview_setup-nogit.sh`. It does not require cloning the repository and downloads the current `radarview.py` automatically.

```bash
sudo apt update
sudo apt install -y curl wget ca-certificates

curl -fsSL https://raw.githubusercontent.com/br3jski/radarview/refs/heads/main/radarview_setup-nogit.sh -o radarview_setup-nogit.sh
chmod +x radarview_setup-nogit.sh

sudo ./radarview_setup-nogit.sh
```

The script will ask for your token:

```text
Please enter your RadarView token (format: ADS-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX):
```

Paste the token from **My Account**.

## 4. What The Script Does

The script:

1. Checks that it is running as `root`.
2. Validates the user token.
3. Checks whether a local ADS-B source exists:
   - `dump1090-fa`
   - `dump1090-mutability`
   - `dump1090`
   - `readsb`
4. If no dump1090/readsb installation is found, it asks whether to install `dump1090-fa`.
5. Downloads `radarview.py` to:

```text
/opt/radarview.py
```

6. Inserts your token into:

```python
USER_TOKEN = 'ADS-...'
```

7. Creates a systemd service:

```text
/etc/systemd/system/radarview.service
```

8. Starts and enables the service:

```bash
systemctl start radarview
systemctl enable radarview
```

## 5. How Data Forwarding Works

`radarview.py` connects to your local ADS-B receiver on the SBS/BaseStation port:

```text
127.0.0.1:30003
```

Then it forwards the data to ADS-B.Pro:

```text
feed.ads-b.pro:48581
```

Before every aircraft data line, the script sends your token:

```text
TOKEN:ADS-...
```

So two things are required:

- local `dump1090` / `readsb` must expose SBS data on `127.0.0.1:30003`,
- the feeder machine must be able to make an outbound TCP connection to `feed.ads-b.pro:48581`.

## 6. Verify The Installation

Check service status:

```bash
sudo systemctl status radarview
```

Watch live logs:

```bash
sudo journalctl -u radarview -f
```

Healthy logs should look similar to:

```text
Connected to source 127.0.0.1:30003
Connected to destination feed.ads-b.pro:48581
Data sent with token
```

Check local ADS-B source:

```bash
nc -vz 127.0.0.1 30003
```

Check ADS-B.Pro connectivity:

```bash
nc -vz feed.ads-b.pro 48581
```

## 7. If You Use readsb

Make sure `readsb` exposes SBS/BaseStation output on port `30003`. The feeder script does not read JSON or Beast directly. It expects text SBS data from port `30003`.

Your `readsb` configuration should include the equivalent of:

```text
--net
--net-sbs-port 30003
```

Restart `readsb` after changing its configuration.

## 8. Changing The Token Later

If the token was pasted incorrectly or regenerated, the easiest option is to run the setup script again.

You can also edit `/opt/radarview.py` manually, update:

```python
USER_TOKEN = 'ADS-...'
```

and restart the service:

```bash
sudo systemctl restart radarview
```

## 9. Common Problems

**Invalid token format**  
The token does not match `ADS-` plus 32 hex characters. Copy it again from **My Account**.

**Error: User token not set**  
`USER_TOKEN` in `/opt/radarview.py` is empty. Run the setup again or edit the file manually.

**Socket error for `127.0.0.1:30003`**  
`dump1090` / `readsb` is not running or SBS output is not enabled on port `30003`.

**Socket error for `feed.ads-b.pro:48581`**  
Likely DNS, internet, firewall, or outbound TCP port `48581` connectivity issue.

**Account does not show Feeder status yet**  
The feeder needs to send stable data first. The frontend account status comes from the backend account data, so after approval you may need to log out and back in, or refresh your session token.