Xbox DVR

Xbox DVR uses OpenXBL's API to find and download your latest DVR clips and screenshots.

Download

You can download pre-compiled binaries for macOS, Linux and Windows from the releases page.

Alternatively, you can run the binary from within the pre-built Docker image:

docker run ghcr.io/wolveix/xbox-dvr:latest

Run with Docker

docker run --rm -e apiKey=your-openxbl-api-key -e autoDelete=false -e savePath=/out -v ./xbox-dvr:/out wolveix/xbox-dvr:latest sync

Run with Docker Compose

services:
  xbox-dvr:
    container_name: 'xbox-dvr'
    hostname: 'xbox-dvr'
    image: 'wolveix/xbox-dvr:latest'
    volumes:
      - '/your/output/directory:/out'
    environment:
      - apiKey=your-openxbl-api-key
      - autoDelete=false
      - savePath=/out
    restart: no

Build

To build this application, you'll need Go installed.

git clone https://github.com/wolveix/xbox-dvr.git
cd xbox-dvr
make

This will output a binary called xbox-dvr. You can then move it or use it by running ./bin/xbox-dvr (on Unix devices).

Set API Key

1. Create an account with OpenXBL
2. Verify your email
3. Create an API key
4. Run xdvr config set apiKey your-api-key

Sync Latest DVR Content

To sync your latest DVR content, run:

xdvr sync

Delete Content From XBL

To automatically delete clips from XBL once they've been downloaded, run:

xdvr config set autoDelete true

Global Flags

Flag	Short	Description
--debug	-d	Print debug logs (default false)
--prettyLog		Pretty print logs to console (default true)
--timeout	-t	Timeout duration for downloads (default 60s)

License

This repository is licensed under the Apache License version 2.0.

Some of the project's dependencies may be under different licenses.