Full disc uploads¶
upPollo supports complete Blu-ray and DVD releases as folders or disc images. It detects the disc structure, reads metadata from the main feature, creates screenshots, and builds a torrent that keeps the disc files intact.
Full disc support is currently in beta. Check the generated metadata and tracker form before confirming an upload.
Supported layouts¶
Blu-ray¶
Supported inputs:
- A release directory containing
BDMV/ - A release directory containing one or more disc directories, each with
BDMV/ - A directory containing exactly one Blu-ray
.isofile - A release directory containing one or more disc directories, each with exactly one
Blu-ray
.isofile
Examples:
Movie.2024.COMPLETE.BLURAY-GROUP/
└── BDMV/
Movie.2024.COMPLETE.UHD.BLURAY-GROUP/
├── Disc01/BDMV/
└── Disc02/BDMV/
Movie.2024.COMPLETE.BLURAY-GROUP/
└── Movie.2024.COMPLETE.BLURAY-GROUP.iso
Show.S01.COMPLETE.BLURAY-GROUP/
├── Show.S01D01.COMPLETE.BLURAY-GROUP/
│ ├── group-show.s01d01.iso
│ └── group-show.s01d01.nfo
└── Show.S01D02.COMPLETE.BLURAY-GROUP/
├── group-show.s01d02.iso
└── group-show.s01d02.nfo
An ISO is accepted when it is a UDF image, or when it carries an ISO9660
structure with a BDMV entry. Blu-ray discs use UDF 2.50 and the additional
ISO9660 bridge layer is optional, so nearly all Blu-ray images are UDF-only.
Their contents are not inspected up front: if such an image turns out to have no
BDMV structure, the upload aborts during the disc scan.
The disc scanner reads images over UDF only. An ISO9660-only image, or a bridge image that lists its ISO9660 descriptors first, is rejected with a message saying so — rebuild it as a UDF image to upload it. A directory with multiple ISO files is ambiguous and is not detected as a Blu-ray image upload. The same applies to a release whose disc directories do not each hold exactly one Blu-ray image.
DVD¶
Supported inputs:
- A release directory containing
VIDEO_TS/ - A release directory containing one or more disc directories, each with
VIDEO_TS/ - A directory containing exactly one DVD
.isoor.imgfile
Examples:
Movie.2004.COMPLETE.PAL.DVD9-GROUP/
└── VIDEO_TS/
Movie.2004.COMPLETE.PAL.DVD9-GROUP/
├── Disc01/VIDEO_TS/
└── Disc02/VIDEO_TS/
Movie.2004.COMPLETE.PAL.DVD9-GROUP/
└── Movie.2004.COMPLETE.PAL.DVD9-GROUP.iso
A DVD image must use the ISO9660 format and contain VIDEO_TS at its root. Renamed
files without a valid DVD structure are rejected. A directory with multiple image
files is also rejected as ambiguous.
Series discs¶
For a full-disc series, a release name can carry a season and disc marker
(S01D01, S01D02, ...) instead of, or alongside, a year, e.g.
MobLand.S01D01.COMPLETE.BLURAY-GROUP. The disc marker is carried into the
enriched release name, so discs of the same season don't produce identical
names.
A season directory with one image per disc directory is uploaded as a season pack without a disc marker.
The RocketHD dupe check treats discs with different disc numbers as separate
uploads. An existing upload without a disc marker may be the same disc under an
older name, so it is only ruled out when its size falls outside
size_similarity.
Uploading a disc¶
Pass the release directory to the normal upload command:
upPollo upload "/path/to/Movie.2024.COMPLETE.UHD.BLURAY-GROUP"
upPollo upload "/path/to/Movie.2004.COMPLETE.PAL.DVD9-GROUP"
The normal identification, filter, dupe-check, upload, and torrent-client settings
still apply. Full disc detection sets the tracker upload type to Complete Disc.
Checks before the disc scan¶
The Blu-ray scan reads the selected playlist, tens of gigabytes for a BD50, and a DVD image has its main title copied to the temporary directory. upPollo first runs the checks that do not need the disc contents. When no tracker is left after them, it skips the scan, the DVD extraction and the screenshots:
- In API and unattended mode, a complete DVD counts as SD whatever its name says.
Without
--allow-sdorAllowSD, aVIDEO_TSfolder or DVD image is rejected before identification. - Tracker checks that only need the identification, such as the anime check of AnimeWorld, run directly after it.
- Each tracker is asked for full-disc uploads of the same title, season or episode in any resolution. An upload of exactly the same size is a dupe, as in the regular dupe check after the scan, and that tracker is skipped. On RocketHD, an upload with a different disc number does not count, as in the regular check. Uploads that only have a similar name or size, or that the tracker lists under another type, are left to the regular check after the scan. If the lookup fails, upPollo shows a warning and continues with the scan.
A tracker with seed_on_dupe is not asked before the scan: whether upPollo seeds the
dupe also depends on the filters that read the disc, so it goes through the regular
dupe check. Dry runs and /api/upload/check do the same. --ignore-dupe and
--trump skip the early lookup like the regular dupe check.
Blu-ray processing¶
upPollo uses go-bdinfo to inspect Blu-ray folders and ISO files directly. It does not mount or unpack Blu-ray images: screenshots are taken by reading the stream files in place, at the byte ranges the image's UDF structure points to.
For each disc, upPollo ranks playlists by stream size, total size, duration, and
stream concentration. Playlists that play the same streams repeatedly ("play all"
and looping playlists) report more data than the disc holds; they are ranked by a
single pass over their streams so they do not outrank the main feature. Playlists
that go beyond that and are rejected as looping or as shorter than two minutes are
marked (looping or short) and sorted behind every other playlist. They are kept
as choices because on some discs — TV box sets whose playlists all replay a shared
opening and ending — no playlist passes that check at all. When the top choice is
one of them, upPollo warns before the selection. Interactive uploads show the five
highest-scoring choices:
- Press Enter to select the default playlist.
- Enter one or more playlist numbers separated by commas.
- Enter
ALLto scan every displayed playlist. - With
--unattended, upPollo selects the highest-scoring playlist.
The selected playlist provides the BD info submitted to the tracker and the timing data used for screenshots. For an unpacked disc, the corresponding stream file is also used for release-name enrichment. Multi-disc releases, whether as folders or as one image per disc directory, are scanned one disc at a time, with the first disc used as the primary tracker metadata source.
DVD processing¶
For an unpacked DVD, upPollo finds the largest title set under VIDEO_TS. It reads
MediaInfo from that title's IFO and uses its VOB files for additional metadata and
screenshots. The total size of each disc is classified as DVD5 or DVD9 and added
to the release name when needed.
For a DVD ISO or IMG file, upPollo selects the largest title set inside the image and copies only its IFO and consecutive VOB parts to the temporary directory. The source image is not modified. The extracted files are used only for metadata, name enrichment, and screenshots. Torrent creation still uses the original disc image.
Before extraction, upPollo checks that the temporary filesystem has enough free space
for the selected IFO and VOB files. Configure the temporary location with temp_folder
if the default filesystem is too small.
Screenshots and FFmpeg¶
Screenshots use the selected Blu-ray playlist or the main DVD title. The regular
screenshots configuration controls the count, image hosts, and FFmpeg path.
Screenshots from a Blu-ray image do not need a special FFmpeg build. upPollo reads the image's UDF structure itself, locates the stream files the selected playlist plays, and hands FFmpeg the byte range around each screenshot position. FFmpeg therefore sees a plain MPEG-TS stream and never has to seek through libbluray, which is what used to fail on discs whose clip timing libbluray cannot use. DVD ISO and IMG screenshots do not require a special protocol either, because upPollo extracts the main title first.
The position of each screenshot is derived from its share of the playlist duration, so on a disc with a strongly varying bitrate a screenshot can land somewhat before or after the calculated timestamp. The frames themselves are correct; only their exact position in the feature shifts.
Encrypted Blu-ray images are not supported: their stream files cannot be read as plain MPEG-TS.
HDR and Dolby Vision sources may need additional FFmpeg filters. See Custom FFmpeg for setup and verification.
Torrent contents¶
The generated torrent preserves the complete disc structure. Files such as .xml,
.jpg, and .png inside BDMV/ or CERTIFICATE/ are retained because they can be
part of a valid Blu-ray structure.
Top-level directories named Proof or Sample are excluded from full disc torrents.
When either directory is present, upPollo prepares a temporary linked or copied tree
using the configured link_mode. The source release remains unchanged.
Temporary files¶
Temporary scan reports, DVD image extractions, screenshots, and staged torrent input
are removed when the upload finishes or fails. Pass --keep-temp to retain them for
inspection:
The retained path is printed in the command output. Remove it manually after
troubleshooting. In API mode the screenshots sit in a directory of their own next to
it (.screenshots-*), because a RocketHD upload can return before they are hosted.
It is removed once they are hosted; with KeepTemp its path is printed as well.
Troubleshooting¶
- Disc is treated as a regular release: Check that
BDMVorVIDEO_TSis at the release root or one directory below it. For an image, verify that only one supported image file is present in the release directory, or in each disc directory. - No Blu-ray playlists found: Check that
BDMV/PLAYLISTandBDMV/STREAMare complete and readable. For an image, the scanner reads it over UDF, so an ISO9660-only or ISO9660/UDF bridge image has to be rebuilt as UDF. - Blu-ray ISO screenshots fail: Check the message for what upPollo could not
read.
locate the streams of playlistmeans the image's UDF structure or the selected playlist could not be resolved; enable debug logging to see which stream files the playlist references and how large they are. - DVD image extraction reports insufficient space: Move
temp_folderto a filesystem with enough free space for the main title. - DVD main title is not found: Check that the image or folder contains a complete
VIDEO_TSstructure with matchingVTS_XX_0.IFOandVTS_XX_1.VOBfiles. - Unexpected files appear in the torrent: Only top-level
ProofandSampledirectories receive special handling. Other files are preserved as part of the release.
If the structure is valid but detection or scanning still fails, enable debug logging and report the issue with the sanitized log output. Do not include tracker keys, announce URLs, passkeys, or client passwords.