Skip to content

Commit 7944f58

Browse files
chore: update readme.txt with linux example
1 parent 664bb78 commit 7944f58

File tree

1 file changed

+59
-2
lines changed

1 file changed

+59
-2
lines changed

enduser/readme.txt

Lines changed: 59 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,71 @@ If you do not want to use it this way, then just remove both the files 'add_trac
44
These '.txt' files must be place in the same directory as the program.
55

66
--------------------
7+
--- Linux usage example : 1 (public trackers)
8+
Update all the torrent files with only the latest tested stable tracker.
9+
10+
curl https://newtrackon.com/api/stable --output add_trackers.txt
11+
echo > remove_trackers.txt
12+
./trackereditor ../test_torrent -U0
13+
14+
Line 1: This will download the latest stable trackers into add_trackers.txt
15+
Line 2: Remove_trackers.txt is now a empty file. All trackers from the present torrent will be REMOVED.
16+
Line 3: Update all the torrent files inside the test_torrent folder.
17+
18+
note -U0 parameter can be change to -U4 (sort by name)
19+
This is my prefer setting for the rtorrent client.
20+
rtorrent client announce to all the trackers inside the torrent file.
21+
I prefer to see all the trackers in alphabetical order inside rtorrent client console view.
22+
rtorrent client need to have the 'session' folder cleared and restart rtorrent to make this working.
23+
This can be run via regular cron job to keep the client running with 100% functional trackers.
24+
25+
--- Linux usage example: 2 (public trackers)
26+
Mix the latest tested stable tracker with the present trackers already present inside the torrent files.
27+
28+
curl https://raw.githubusercontent.com/ngosang/trackerslist/master/trackers_best.txt --output add_trackers.txt
29+
curl https://raw.githubusercontent.com/ngosang/trackerslist/master/blacklist.txt --output remove_trackers.txt
30+
./trackereditor ../test_torrent -U0
31+
32+
Line 1: This will download the latest stable trackers into add_trackers.txt
33+
Line 2: Remove_trackers.txt now contain blacklisted trackers
34+
Line 3: Update all the torrent files inside the test_torrent folder.
35+
36+
Diference betwean example 1 vs 2
37+
Example 1 is guarantee that all the trackers are working.
38+
Example 2 You are responseble for the trackers working that are not part of add_trackers.txt
39+
40+
--- Linux usage example: 3 (private trackers)
41+
In add_trackers.txt file manualy the private tracker URL
42+
echo > remove_trackers.txt
43+
./trackereditor ../test_torrent -U0 -SAC -SOURCE "abcd"
44+
45+
Line 2: Remove_trackers.txt is now a empty file. All trackers from the present torrent will be REMOVED.
46+
Line 3: Update all the torrent files inside the test_torrent folder.
47+
-SAC (Skip Annouce Check) This is needed to skip private tracker URL check.
48+
-SOURCE Add private tracker source tag "abcd"
49+
50+
-SOURCE is optionally.
51+
-SOURCE "" Empty sting will remove all the source tag
52+
--------------------
53+
54+
Usage example Windows desktop short cut for private tracker user.
55+
This is the same idea as "Usage example: 3 (private trackers)"
56+
But start it from the desktop shortcut (double click) and not from windows console via bat file etc.
57+
58+
Desktop shortcut can have extra parameter append.
59+
C:\Users\root\Documents\github\bittorrent-tracker-editor\enduser\trackereditor.exe ..\test_torrent -U0 -SAC -SOURCE abc
60+
61+
Make sure that add_trackers.txt is filled with the private URL
62+
And remove_trackers.txt is a empty file.
763

8-
Console mode:
64+
--------------------
65+
66+
Console mode windows example:
967
Start program with a parameter to torrent file or dir
1068
trackereditor.exe "C:\dir\torrent\file.torrent" -U4
1169
trackereditor.exe "C:\dir\torrent" -U4
1270
What tracker will be added/removed depend the content of the add_trackers.txt and remove_trackers.txt files.
1371

14-
--------------------
1572

1673
Additional Files: Trackers file and log file
1774
These 3 files can be optionally present in the same dir as the trackereditor executable file.

0 commit comments

Comments
 (0)