Skip to content

GrzybDev/QuantumFetcher

Repository files navigation

Quantum Fetcher

Tool for fetching Quantum Break live action episodes for offline in-game playback

Table of Contents

Game Info

Quantum Break Cover

Type Value
Developer(s) Remedy Entertainment
Publisher(s) Microsoft Studios
Director(s) Sam Lake, Mikael Kasurinen
Producer(s) Miloš Jeřábek
Engine Northlight Engine
Platform(s) Windows, Xbox One
Genre(s) Action-adventure, third-person shooter
Mode(s) Single-player

Legal notes

  • The project doesn't contain any original assets from the game!
  • To use this project you need to have an original copy of the game (bought from Steam), the project doesn't make piracy easier and doesn't break any of the DRM included in-game.

Features

  • Download all Quantum Break Live Action episodes in selected languages and bitrates for offline in-game playback.
  • Text streams extraction to JSON
  • Dump contents of videoList.rmdj
  • Patch videoList.rmdj to point to custom QuantumStreamer compatible server.
  • Build videoList.rmdj from any JSON file.

Requirements

  • Python 3.10+

Installing

Either use compiled portable build for Windows or Linux from Releases page or use your python package management system (like pipx or uv)

Example: pipx install git+https://github.com/GrzybDev/QuantumFetcher.git

Usage

quantumstreamer --help

You can run this tool in interactive mode or non-interactive mode.

By default, if no filters are provided then english audio and subtitles will be downloaded with highest quality video stream.

In interactive mode, you will be asked which episodes you want to download, in which quality, languages etc. to run this tool in interactive mode use --interactive flag

Both interactive mode and non-interactive mode supports these two optional parameters:

Parameter Description Default value
--videolist-path Path to videoList.rmdj file data/videoList.rmdj
--episodes-path Path to where episodes will be saved videos/episodes

Supported filters are provided below:

Parameter Description
--episodes Comma-separated list of episode IDs to download
--video-resolutions Comma-seperated list of video resolutions to download
--video-bitrates Comma-seperated list of video bitrates to download
--audio-languages Comma-seperated list of audio languages to download
--audio-bitrates Comma-seperated list of audio bitrates to download
--text-languages Comma-seperated list of text languages to download
--text-bitrates Comma-seperated list of text bitrates to download

Note: All filters support all value (Example: --audio-languages all will download audio tracks in all languages)

You can view available formats (bitrates, languages etc.) by running Quantum Fetcher with --show-formats flag.

This tool also can patch original videoList.rmdj file to make game point to QuantumStreamer compatible server.

To patch videoList.rmdj run this tool with --patch-videolist flag, by default, it will update videoList.rmdj to point to 127.0.0.1:10000.

You can change the default to any other host that is compatible with QuantumStreamer, to do that just set --patch-videolist-server.

You can also build the videoList.rmdj file from scratch by providing JSON file path via --build-videolist-path parameter, you can specify the output path via --videolist-path parameter.

In order to dump contents of videoList.rmdj file, you need to provide --dump-videolist-path which is where output JSON will be saved, you can also print the contents of that file to console by setting this parameter to -.

Running tool with --extract-subtitles flag will extract text streams to JSON file usable by QuantumStreamer

In order to be able to use downloaded episodes, you need to install QuantumStreamer.

Credits

Special thanks to:

  • Remedy Entertainment (for making the game)
  • Microsoft Studios (for publishing the game on PC)
  • r00t0 - For help with decoding videoList.rmdj

About

Tool for fetching Quantum Break live action episodes for offline in-game playback

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages