OMSS IDs

Learn about the OMSS ID format and how it is used to identify and resolve media in OMSS Core.

OMSS Core (unlike the current OMSS) does not use TMDB as the primary identifier for media. Instead, it uses a new identifier format called the OMSS ID. The OMSS ID is a unique identifier that can be used to identify and resolve media across different providers and services.

Format

OMSS identifiers follow the format <namespace>:<value_1>:<value_2>:...:<value_n>. Values can contain any character except colons and whitespaces. If a value or namespace contains a forbidden character, it must be URI-encoded (%3A for colons and %20 for whitespaces).

Namespaces are used to differentiate between different ID-Providers and their respective identifier values. The namespace is the first part of the OMSS ID, followed by one or more values that uniquely identify the media within that namespace.

OMSS Builder

You can use the OMSS ID Builder below to create a valid OMSS ID. Enter the namespace and values, and the builder will generate the corresponding OMSS ID for you.