QuantumFetcher

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 13 Open GitHub ↗

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Quantum Fetcher

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

Table of Contents
-----------------
- [Game Info](#game-info)
- [Legal notes](#legal-notes)
- [Features](#features)
- [Requirements](#build-requirements)
- [Installing](#installing)
- [Usage](#usage)
- [Credits](#credits)

Game Info
---------
![Quantum Break Cover](https://upload.wikimedia.org/wikipedia/en/d/d9/Quantum_Break_cover.jpg "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](https://store.steampowered.com/app/474960/Quantum_Break/)), 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 SubRip (.srt)
- Dump contents of `videoList.rmdj`
- Patch `videoList.rmdj` to point to custom [QuantumStreamer](https://github.com/GrzybDev/QuantumStreamer.git) 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](https://github.com/GrzybDev/QuantumFetcher/releases) page or use your python package management system (like `pipx` or `uv`)

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

Usage
-----

```sh
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](https://github.com/GrzybDev/QuantumStreamer.git) 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](https://github.com/GrzybDev/QuantumStreamer.git), 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 SubRip format (.srt) usable by [QuantumStreamer](https://github.com/GrzybDev/QuantumStreamer.git)

In order to be able to use downloaded episodes, you need to install [QuantumStreamer](https://github.com/GrzybDev/QuantumStreamer.git).

Credits
-------

- [GrzybDev](https://grzyb.dev)

Special thanks to:
- Remedy Entertainment (for making the game)
- Microsoft Studios (for publishing the game on PC)
- [r00t0](https://github.com/cleverzaq) - For help with decoding `videoList.rmdj`

QuantumFetcher

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README