feat: add TOS tracker support (Audionut#1120)

Co-authored-by: Audionut <audionut@riseup.net> Co-authored-by: wastaken7 <46319635+wastaken7@users.noreply.github.com>
PythonCoderAS · Jan 11, 2026 · Jan 11, 2026 · Jan 11, 2026 · Jan 11, 2026 · Jan 11, 2026
commit c11b7f15a03f9abf67db14f0ccf3173aaccf5330
diff --git a/README.md b/README.md
@@ -64,10 +64,11 @@ Many thanks to all who have contributed.
 |ShareIsland|SHRI|SkipTheCommerials|STC|
 |SpeedApp|SPD|Swarmazon|SN|
 |The Leach Zone|TLZ|ToTheGlory|TTG|
-|TorrentHR|THR|Torrenteros|TTR|
-|TorrentLeech|TL|TVChaosUK|TVC|
-|ULCX|ULCX|UTOPIA|UTP|
-|YOiNKED|YOINK|YUSCENE|YUS|
+|TheOldSchool|TOS|TorrentHR|THR|
+|Torrenteros|TTR|TorrentLeech|TL|
+|TVChaosUK|TVC|ULCX|ULCX|
+|UTOPIA|UTP|YOiNKED|YOINK|
+|YUSCENE|YUS|||
 
 ## **Setup:**
    - **REQUIRES AT LEAST PYTHON 3.9 AND PIP3**

diff --git a/data/example-config.py b/data/example-config.py
@@ -322,7 +322,7 @@
 
     "TRACKERS": {
         # Which trackers do you want to upload to?
-        # Available tracker: ACM, AITHER, ANT, AR, ASC, AZ, BHD, BHDTV, BJS, BLU, BT, CBR, CZ, DC, DP, EMUW, FF, FL, FNP, FRIKI, GPW, HDB, HDS, HDT, HHD, HUNO, IHD, IS, ITT, LCD, LDU, LST, LT, MTV, NBL, OE, OTW, PHD, PT, PTER, PTP, PTS, PTT, R4E, RAS, RF, RTF, SAM, SHRI, SN, SP, SPD, STC, THR, TIK, TL, TLZ, TTG, TTR, TVC, ULCX, UTP, YOINK, YUS
+        # Available tracker: ACM, AITHER, ANT, AR, ASC, AZ, BHD, BHDTV, BJS, BLU, BT, CBR, CZ, DC, DP, EMUW, FF, FL, FNP, FRIKI, GPW, HDB, HDS, HDT, HHD, HUNO, IHD, IS, ITT, LCD, LDU, LST, LT, MTV, NBL, OE, OTW, PHD, PT, PTER, PTP, PTS, PTT, R4E, RAS, RF, RTF, SAM, SHRI, SN, SP, SPD, STC, THR, TIK, TL, TLZ, TOS, TTG, TTR, TVC, ULCX, UTP, YOINK, YUS
         # Only add the trackers you want to upload to on a regular basis
         "default_trackers": "",
 
@@ -825,6 +825,17 @@
             "api_key": "",
             "anon": False,
         },
+        "TOS": {
+            # Instead of using the tracker acronym for folder name when sym/hard linking, you can use a custom name
+            "link_dir_name": "",
+            # Mon profil > Réglages > Clé API
+            "api_key": "",
+            # Mon profil > Réglages > Passkey
+            "announce_url": "https://theoldschool.cc/announce/PasskeyHere",
+            "anon": False,
+            # Upload with Exclusive flag (team of staff only)
+            "exclusive": False,
+        },
         "TTG": {
             # Instead of using the tracker acronym for folder name when sym/hard linking, you can use a custom name
             "link_dir_name": "",

diff --git a/docs/cli-args.md b/docs/cli-args.md
@@ -107,13 +107,14 @@ Note: if a manual TMDb or IMDb id is present in the incoming `meta` before parsi
 
 ### Misc metadata flags
 
-- `--not-anime`: Manually mark release as not anime. NOTE: invokes a quicker processing path for TV content when metadata ids (such as TMDB) are also provided
+- `--not-anime`: Manually mark release as not anime. NOTE: invokes a quicker processing path for TV content when metadata ids (such as TMDB) are also provided.
 - `-year`, `--year YYYY`: Override the year found.
 - `-mc`, `--commentary`: Manually indicate commentary tracks are included.
 - `-sfxs`, `--sfx-subtitles`: Manually indicate “SFX subtitles” are included.
 - `-e`, `--extras`: Indicates extras are included (mainly Blu-ray discs).
-- `-sort`, `--sorted-filelist`: Use the largest video file instead of the first video file found. NOTE: useful for anime content when additional content is present in a folder
+- `-sort`, `--sorted-filelist`: Use the largest video file instead of the first video file found. NOTE: useful for anime content when additional content is present in a folder.
 - `-kf`, `--keep-folder`: Keep the folder containing the single file (only when supplying a directory).
+- `-knfo`, `--keep-nfo`: Keep nfo file where applicable for specific tracker/s. With single files, must be used in conjunction with `--keep-folder` above.
 - `-reg`, `--region REGION`: Region for discs.
 
 ## Tracker-specific references (existing torrent ids/links)

diff --git a/src/args.py b/src/args.py
@@ -152,6 +152,7 @@ def parse(self, args, meta):
         parser.add_argument('-nfo', '--nfo', action='store_true', required=False, help="Use .nfo in directory for description")
         parser.add_argument('-k', '--keywords', nargs=1, required=False, help="Add comma separated keywords e.g. 'keyword, keyword2, etc'")
         parser.add_argument('-kf', '--keep-folder', action='store_true', required=False, help="Keep the folder containing the single file. Works only when supplying a directory as input. For uploads with poor filenames, like some scene.")
+        parser.add_argument('-knfo', '--keep-nfo', action='store_true', required=False, help="For specific trackers only, allows to keep nfo files. With single files, must be used in conjuction with --keep-folder to find the nfo in the same folder as the file.", dest="keep_nfo")
         parser.add_argument('-reg', '--region', nargs=1, required=False, help="Region for discs")
         parser.add_argument('-a', '--anon', action='store_true', required=False, help="Upload anonymously")
         parser.add_argument('-st', '--stream', action='store_true', required=False, help="Stream Optimized Upload")

diff --git a/src/audio.py b/src/audio.py
@@ -430,7 +430,7 @@ def bloated_check(meta, audio_languages, is_eng_original_with_non_eng=False):
     if isinstance(audio_languages, str):
         audio_languages = [audio_languages]
 
-    bloat_is_allowed = ["ASC", "BJS", "BT", "CBR", "DC", "FF", "LCD", "SAM", "SHRI", "SP", "TL"]
+    bloat_is_allowed = ["ASC", "BJS", "BT", "CBR", "DC", "FF", "LCD", "SAM", "SHRI", "SP", "TL", "TOS"]
     tracker_allowed_bloat_language = {
         "AITHER": "en",
         "ANT": "en",

diff --git a/src/clients.py b/src/clients.py
@@ -3161,6 +3161,7 @@ async def match_tracker_url(tracker_urls, meta):
         'thr': ["torrenthr"],
         'tl': ["tracker.tleechreload", "tracker.torrentleech"],
         'tlz': ["https://tlzdigital.com/"],
+        'tos': ["https://theoldschool.cc"],
         'ttr': ["https://torrenteros.org"],
         'tvc': ["https://tvchaosuk.com"],
         'ulcx': ["https://upload.cx"],

diff --git a/src/torrentcreate.py b/src/torrentcreate.py
@@ -168,39 +168,50 @@ async def create_torrent(
             include: list[str] = []
             exclude: list[str] = []
 
-            if meta['isdir']:
-                if meta['keep_folder']:
-                    cli_ui.info('--keep-folder was specified. Using complete folder for torrent creation.')
-                    if not meta.get('tv_pack', False):
-                        folder_name = os.path.basename(str(path))
-                        include = [
-                            f"{folder_name}/{os.path.basename(f)}"
-                            for f in meta['filelist']
-                        ]
-                        exclude = ["*", "*/**"]
+            if meta['keep_folder']:
+                console.print('--keep-folder was specified. Using complete folder for torrent creation.')
+                # specific nfo catch for certain trackers. BASE catch should prevent unintentional inclusion by default
+                if meta.get('keep_nfo', False) and "BASE" not in output_filename:
+                    console.print('--keep-nfo was specified. Including NFO files in torrent.')
+                    include = ["*.mkv", "*.mp4", "*.ts", "*.nfo"]
+                    exclude = ["*.*", "*sample.mkv"]
+                    meta['mkbrr'] = False
+                elif not meta.get('tv_pack', False):
+                    folder_name = os.path.basename(str(path))
+                    include = [
+                        f"{folder_name}/{os.path.basename(f)}"
+                        for f in meta['filelist']
+                    ]
+                    exclude = ["*", "*/**"]
+
+            elif meta['isdir']:
+                if meta.get('keep_nfo', False) and not meta.get('is_disc', False) and "BASE" not in output_filename:
+                    console.print('--keep-nfo was specified. Including NFO files in torrent.')
+                    include = ["*.mkv", "*.mp4", "*.ts", "*.nfo"]
+                    exclude = ["*.*", "*sample.mkv"]
+                    meta['mkbrr'] = False
+                elif meta.get('is_disc', False):
+                    include = []
+                    exclude = []
+                elif not meta.get('tv_pack', False):
+                    path_dir = os.fspath(path)
+                    os.chdir(path_dir)
+                    globs = glob.glob1(path_dir, "*.mkv") + glob.glob1(path_dir, "*.mp4") + glob.glob1(path_dir, "*.ts")
+                    no_sample_globs = [
+                        os.path.abspath(f"{path_dir}{os.sep}{file}") for file in globs
+                        if not file.lower().endswith('sample.mkv') or "!sample" in file.lower()
+                    ]
+                    if len(no_sample_globs) == 1:
+                        path = meta['filelist'][0]
+                    exclude = ["*.*", "*sample.mkv", "!sample*.*"] if not meta['is_disc'] else []
+                    include = ["*.mkv", "*.mp4", "*.ts"] if not meta['is_disc'] else []
                 else:
-                    if meta.get('is_disc', False):
-                        include = []
-                        exclude = []
-                    elif not meta.get('tv_pack', False):
-                        path_dir = os.fspath(path)
-                        os.chdir(path_dir)
-                        globs = glob.glob1(path_dir, "*.mkv") + glob.glob1(path_dir, "*.mp4") + glob.glob1(path_dir, "*.ts")
-                        no_sample_globs = [
-                            os.path.abspath(f"{path_dir}{os.sep}{file}") for file in globs
-                            if not file.lower().endswith('sample.mkv') or "!sample" in file.lower()
-                        ]
-                        if len(no_sample_globs) == 1:
-                            path = meta['filelist'][0]
-                        exclude = ["*.*", "*sample.mkv", "!sample*.*"] if not meta['is_disc'] else []
-                        include = ["*.mkv", "*.mp4", "*.ts"] if not meta['is_disc'] else []
-                    else:
-                        folder_name = os.path.basename(str(path))
-                        include = [
-                            f"{folder_name}/{os.path.basename(f)}"
-                            for f in meta['filelist']
-                        ]
-                        exclude = ["*", "*/**"]
+                    folder_name = os.path.basename(str(path))
+                    include = [
+                        f"{folder_name}/{os.path.basename(f)}"
+                        for f in meta['filelist']
+                    ]
+                    exclude = ["*", "*/**"]
             else:
                 exclude = ["*.*", "*sample.mkv", "!sample*.*"] if not meta['is_disc'] else []
                 include = ["*.mkv", "*.mp4", "*.ts"] if not meta['is_disc'] else []

diff --git a/src/trackers/COMMON.py b/src/trackers/COMMON.py
@@ -6,10 +6,12 @@
 import hashlib
 import httpx
 import json
+import langcodes
 import os
 import re
 import secrets
 import sys
+from langcodes import tag_parser
 from src.bbcode import BBCODE
 from src.console import console
 from src.exportmi import exportInfo
@@ -1019,20 +1021,74 @@ async def read_and_clean():
     async def check_language_requirements(
         self,
         meta: dict[str, Any],
-        tracker,
-        languages_to_check,
-        check_audio=False,
-        check_subtitle=False,
-        require_both=False,
-    ):
-        """Check if the given media meets language requirements."""
+        tracker: str,
+        languages_to_check: List[str],
+        check_audio: bool = False,
+        check_subtitle: bool = False,
+        require_both: bool = False,
+        original_language: bool = False,
+    ) -> bool:
+        """
+        Check if the media metadata meets specific language requirements for audio and/or subtitles.
+
+        The function evaluates whether the provided media contains the required languages.
+        It can also handle logic for original language tracks and cross-reference them
+        with subtitles if the primary audio requirement isn't met.
+
+        :param meta: Dictionary containing media metadata (audio_languages, subtitle_languages, etc.).
+        :type meta: dict[str, Any]
+        :param tracker: Name of the tracker being processed, used for logging/output.
+        :type tracker: str
+        :param languages_to_check: A list of language names or codes to search for.
+        :type languages_to_check: List[str]
+        :param check_audio: If True, validates if required languages are present in audio tracks.
+        :type check_audio: bool
+        :param check_subtitle: If True, validates if required languages are present in subtitle tracks.
+        :type check_subtitle: bool
+        :param require_both: If True, both audio AND subtitle requirements must be satisfied.
+                             If False, satisfying either is enough (OR logic).
+        :type require_both: bool
+        :param original_language: If True, checks if the media's original language matches the audio
+                                  track, allowing a fallback to subtitle-only validation.
+        :type original_language: bool
+        :return: True if language requirements are met, False otherwise.
+        :rtype: bool
+        """
         try:
             if not meta.get("language_checked", False):
                 await process_desc_language(meta, tracker=tracker)
 
+            meta_audio_languages: list[str] = meta.get("audio_languages", [])
+            meta_subtitle_languages: list[str] = meta.get("subtitle_languages", [])
+
             languages_to_check = [lang.lower() for lang in languages_to_check]
-            audio_languages = [lang.lower() for lang in meta.get("audio_languages", [])]
-            subtitle_languages = [lang.lower() for lang in meta.get("subtitle_languages", [])]
+            audio_languages = [lang.lower() for lang in meta_audio_languages]
+            subtitle_languages = [lang.lower() for lang in meta_subtitle_languages]
+            language_display = None
+            original_ok = False
+            if original_language:
+                # Get just the first original language
+                original_language_raw = meta.get("original_language", [])
+                first_lang = ""
+                if original_language_raw:
+                    # Handle both string and list cases
+                    if isinstance(original_language_raw, str):
+                        first_lang = original_language_raw.lower()
+                    elif isinstance(original_language_raw, list) and original_language_raw:
+                        first_lang = original_language_raw[0].lower() if isinstance(original_language_raw[0], str) else ""
+
+                try:
+                    # Clean up the language code - take only the first part before any dash or underscore
+                    clean_lang = first_lang.split('-')[0].split('_')[0].split(',')[0].split(' ')[0].strip().lower()
+                    if clean_lang:
+                        lang = langcodes.Language.get(clean_lang)
+                        language_display = lang.display_name().lower()
+                except (tag_parser.LanguageTagError, LookupError, AttributeError, ValueError) as e:
+                    if meta.get('debug'):
+                        console.print(f"[yellow]Debug: Unable to convert language code '{first_lang}' to full name: {e}[/yellow]")
+
+            if language_display:
+                original_ok = language_display in audio_languages
 
             audio_ok = (
                 not check_audio
@@ -1043,6 +1099,26 @@ async def check_language_requirements(
                 or any(lang in subtitle_languages for lang in languages_to_check)
             )
 
+            if meta.get('debug'):
+                console.print(f"[blue]Debug: Audio Languages Found: {audio_languages}[/blue]")
+                console.print(f"[blue]Debug: Subtitle Languages Found: {subtitle_languages}[/blue]")
+                console.print(f"[blue]Debug: Original Audio Language: {language_display}[/blue]")
+                console.print(f"[blue]Debug: Audio OK: {audio_ok}, Subtitle OK: {subtitle_ok}, Original OK: {original_ok}[/blue]")
+
+            if not audio_ok and original_ok:
+                if subtitle_ok:
+                    return subtitle_ok
+                else:
+                    console.print(
+                        f"[red]Language requirement not met for [bold]{tracker}[/bold].[/red]\n"
+                        f"[yellow]Required subtitles in one of the following with an original audio track:[/yellow] "
+                        f"{', '.join(languages_to_check)}\n"
+                        f"[cyan]Found Audio:[/cyan] {', '.join(audio_languages) or 'None'}\n"
+                        f"[cyan]Found Subtitles:[/cyan] {', '.join(subtitle_languages) or 'None'}\n"
+                        f"[cyan]Original Audio Language:[/cyan] {language_display}"
+                    )
+                    return False
+
             if require_both:
                 if not (audio_ok and subtitle_ok):
                     console.print(