Skip to content

update recceiver docs to remove passing poll reactor #133

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tynanford merged 1 commit into from
Jan 13, 2026
Merged

update recceiver docs to remove passing poll reactor #133

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 17 additions & 14 deletions server/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,34 +38,37 @@ Setup
sqlite3 test.db -init recceiver.sqlite3 .exit
```

Run (for twistd <= 16.0.3)
Run (for twistd >= 16.0.4)

```bash
twistd -n recceiver -f demo.conf
PYTHONPATH=$PWD twistd --nodaemon recceiver -f demo.conf
```

or (see below for discussion)
At some point 'twistd' stopped implicitly searching the working directory.

May need to uncomment `addrlist = 127.255.255.255:5049` in demo.conf
when doing local testing on a computer w/ a firewall.

### Older Recceiver/Twistd Versions

For recceiver <= 1.6, passing the poll reactor was required. See [here](https://github.com/ChannelFinder/recsync/issues/132) for more discussion.

```bash
twistd -r poll -n recceiver -f demo.conf
PYTHONPATH=$PWD twistd -r poll --nodaemon recceiver -f demo.conf
```


Run (for twistd >= 16.0.4)
For older versions of twistd (<= 16.0.3), run

```bash
PYTHONPATH=$PWD twistd -r poll -n recceiver -f demo.conf
twistd --nodaemon recceiver -f demo.conf
```

At some point 'twistd' stopped implicitly searching the working directory.
or (see below for discussion)

May need to uncomment `addrlist = 127.255.255.255:5049` in demo.conf
when doing local testing on a computer w/ a firewall.
```bash
twistd -r poll --nodaemon recceiver -f demo.conf
```

Twisted 14.0.2 seems to have a problem with the epoll() reactor
which raises 'IOError: [Errno 2] No such file or directory'
during startup. Try with the poll() reactor.

```bash
twistd -r poll -n recceiver -f demo.conf
```