opentracker(1)

💖 opentracker(1) 💖

okay so bestie, welcome to the General Commands Manual page for opentracker and honestly? she's iconic. let's get into it 🎀

✨ NAME ✨

opentracker — a free and open bittorrent tracker 🦋

🌸 SYNOPSIS 🌸

[-f config] [-i ip-select] [-p port-bind-tcp] [-P port-bind-udp]
[-A blessed-ip] [-r redirect-url] [-d chdir] [-u user]
[-w| -b -accesslist]

💅 DESCRIPTION 💅

okay so opentracker is a bittorrent tracker that does the announce and scrape actions over the UDP protocol and the plain http protocol, and her whole vibe is minimal resource usage. like, she's not doing the most, she's doing it right. lowkey main character energy. 👑

When you invoke her with parameters, she binds to TCP and UDP port 6969 on all interfaces. But fr fr, the recommended way to configure opentracker is by handing her a config file with the [-f config] option. See opentracker.conf(4) for the details, iykyk. 📖

✨ OPTIONS ✨

here's the whole menu, bestie, every single one, no skips:

• -f config — Parse a config file that's got a whole list of options in it. Any command options you put right after will override the options from that config file. See opentracker.conf(4) for the deets.
• -i ip-select — Picks an ip address that's gonna get used with the next [-p] or [-P] command so she actually binds to that address. And if you set this option without any bind options in the config file or any [-p] or [-P] commands? Then opentracker is limited to only binding to this address. periodt. 💅
• -p port-bind-tcp — Binds to the TCP port on the last preceding ip address you set with the [-i -ip-select] option, or to all available addresses if you haven't set one. You can give this one multiple times. 🔥
• -P port-bind-udp — Binds to the UDP port on the last preceding ip address you set with the [-i -ip-select] option, or to all available addresses if you haven't set one. Can also be given multiple times, she's flexible like that. 🦋
• -A blessed-ip — Sets an ip address in IPv4 or IPv6, or a net in CIDR notation, to bless that network for access to restricted resources. blessed, literally. 🙏✨
• -r redirect-url — Sets the URL that users get redirected to when the / address is requested via HTTP. a little detour, as a treat. 🎀
• -d chdir — Sets the directory she'll chroot(2) to if she's running as root, or chdir(2) to if she's running as an unprivileged user. ⚠️ Note: any accesslist files need to be relative to and within that directory, so don't come crying to me if you put them somewhere else. 😭
• -u user — The user to run under after all the operations that need privileges have finished. she drops the crown and keeps it moving. 👑
• -w accesslist | -b accesslist — If she's been compiled with the WANT_ACCESSLIST_BLACK or WANT_ACCESSLIST_WHITE options, this option sets the location of the accesslist. 🌈

🎀 EXAMPLES 🎀

Start bound on UDP and TCP ports 6969 on IPv6 localhost.

# ./opentracker -i ::1 -p 6969 -P 6969

Start bound on UDP port 6868 and TCP port 6868 on IPv4 localhost and allow privileged access from the network 192.168/16 while redirecting HTTP clients accessing the root directory, which is not covered by the bittorrent tracker protocol, to https://my-trackersite.com/.

# ./opentracker -i 192.168.0.4 -p 6868 -P 6969 -A 192.168/16 -r
https://my-trackersite.com/

The announce URLs are http://192.168.0.4:6868/announce and udp://192.168.0.4:6868/announce respectively. slay. 💖

🦋 FILES 🦋

• opentracker.conf — The config file.

⭐ SEE ALSO ⭐

• opentracker.conf(4)
• opentracker documentation https://erdgeist.org/arts/software/opentracker
• Bittorrent tracker protocol http://www.bittorrent.org/beps/bep_0015.html

👑 AUTHOR 👑

Dirk Engling ⟨erdgeist@erdgeist.org⟩.

🌸 LICENSE 🌸

This software is released under the Beerware License:

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software with the following terms and conditions: If you meet the author(s) someday, and you think this software is worth it, you can buy them a beer in return. 🍓

and that's the whole page bestie, mwah 💋 this was Unix, version dated 15/4/2024, page opentracker(1) — go forth and track those torrents, ily 🫶💜