Files
guessit/docs/migration2to3.md

125 lines
3.5 KiB
Markdown

Migration
=========
Guessit 3 has introduced breaking changes from previous versions. You can find in this file all information required to perform a migration from previous version `2.x`.
API
---
No changes.
Properties
----------
Some properties have been renamed.
- `format` is now `source`.
Values
------
The major changes in GuessIt 3 are around the values. Values were renamed in order to keep consistency and to be more intuitive. Acronyms are uppercase (e.g.: `HDTV`). Names follow the official name (e.g.: `Blu-ray`). Words have only the first letter capitalized (e.g.: `Camera`) except prepositions (e.g.: `on`) which are all lowercase.
The following values were changed:
### `source` (former `format` property)
- `Cam` is now `Camera` or `HD Camera`
- `Telesync` is now `Telesync` or `HD Telesync`
- `PPV` is now `Pay-per-view`
- `DVB` is now `Digital TV`
- `VOD` is now `Video on Demand`
- `WEBRip` is now `Web` with additional property `other: Rip`
- `WEB-DL` is now `Web`
- `AHDTV` is now `Analog HDTV`
- `UHDTV` is now `Ultra HDTV`
- `HDTC` is now `HD Telecine`
### `screen_size`
- `360i` was added.
- `480i` was added.
- `576i` was added.
- `900i` was added.
- `4K` is now `2160p`
- `4320p` was added.
### `video_codec`
- `h264` is now `H.264`
- `h265` is now `H.265`
- `Mpeg2` is now `MPEG-2`
- `Real` is now `RealVideo`
- `XviD` is now `Xvid`
### `video_profile`
- `BP` is now `Baseline`.
- `HP` is now `High`.
- `XP` is now `Extended`.
- `MP` is now `Main`.
- `Hi422P` is now `High 4:2:2`.
- `Hi444PP` is now `High 4:4:4 Predictive`.
- `High 10` was added.
- `8bit` was removed. `8bit` is detected as `color_depth: 8-bit`
- `10bit` was removed. `10bit` is detected as `color_depth: 10-bit`
### `audio_codec`
- `DTS-HD` was added.
- `AC3` is now `Dolby Digital`
- `EAC3` is now `Dolby Digital Plus`
- `TrueHD` is now `Dolby TrueHD`
- `DolbyAtmos` is now `Dolby Atmos`.
### `audio_profile`
- `HE` is now `High Efficiency`.
- `LC` is now `Low Complexity`.
- `HQ` is now `High Quality`.
- `HDMA` is now `Master Audio`.
### `edition`
- `Collector Edition` is now `Collector`
- `Special Edition` is now `Special`
- `Criterion Edition` is now `Criterion`
- `Deluxe Edition` is now `Deluxe`
- `Limited Edition` is now `Limited`
- `Theatrical Edition` is now `Theatrical`
- `Director's Definitive Cut` was added.
### `episode_details`
- `Oav` and `Ova` were removed. They are now `other: Original Animated Video`
- `Omake` is now `Extras`
- `Final` was added.
### `other`
- `Rip` was added. E.g.: `DVDRip` will output `other: Rip`
- `DDC` was removed. `DDC` is now `edition: Director's Definitive Cut`
- `CC` was removed. `CC` is now `edition: Criterion`
- `FINAL` was removed. `FINAL` is now `episode_details: Final`
- `Original Animated Video` was added.
- `OV` is now `Original Video`
- `AudioFix` is now `Audio Fixed`
- `SyncFix` is now `Sync Fixed`
- `DualAudio` is now `Dual Audio`
- `Fansub` is now `Fan Subtitled`
- `Fastsub` is now `Fast Subtitled`
- `FullHD` is now `Full HD`
- `UltraHD` is now `Ultra HD`
- `mHD` and `HDLight` are now `Micro HD`
- `HQ` is now `High Quality`
- `HR` is now `High Resolution`
- `LD` is now `Line Dubbed`
- `MD` is now `Mic Dubbed`
- `Low Definition` was added.
- `LiNE` is now `Line Audio`
- `R5` is now `Region 5`
- `Region C` was added.
- `ReEncoded` is now `Reencoded`
- `WideScreen` is now `Widescreen`