Skip to main content

A lightweight, efficient way to backup your media library without duplicating large video files.

Project description

BackupArr


Welcome to the BackupArr repository. This project is currently in its early development stages (Alpha) and aims to provide a lightweight, efficient way to "back up" your media library without duplicating large video files.


The Concept

Traditional backups for media libraries are often prohibitively expensive due to massive file sizes. BackupArr changes the paradigm: instead of backing up the media files themselves, this tool maps your library metadata back to its source. In the event of data loss, you can restore the library state to your download client to re-acquire the media from the swarm.


Project Status: Alpha

Warning: This software is experimental and Work in Progress. It is not recommended for production use. Any and all code is subject to radical changes as development progresses.


Installation

1. pip

  • Install with pip (requires a virtual environment):
    pip install backuparr
    

2. pipx

  • Install with pipx, this requires pipx to be installed. See pipx wiki.
    pipx install backuparr
    

3. Docker (WIP)

  • Currently Work in Progress, will be added later.

First Setup

  • Running First Config Setup:
    backuparr-init
    
    This will copy the .env.example file to the .env file, and will ask for the initial values of the keys.

Usage

  • Changing environment variables

    backuparr-config
    

    This will allow you to change the environment variables via the cmd.

  • Command Structure:

    backuparr [backup|restore] [radarr|sonarr] [filename].json
    
  • Example Command:

    backuparr backup radarr radarr_backup.json
    

Contributing

We welcome all input during these early stages!

  • Open an Issue to discuss new ideas or report bugs.
  • Submit a Pull Request to help with early-stage logic.
  • Check the Discussions tab to help define the project roadmap.

Development

  1. Clone the repository:

    git clone https://github.com/DanielMayhan/BackupArr.git
    cd BackupArr/backuparr
    
  2. Configure Environment: Copy the sample configuration and add your Radarr & Sonarr Api Keys.

    cp .env.example .env
    

Roadmap

These are features and code changes that are either currently being worked on or are planned to be implemented later!

  • Unification of all text in-/outputs
  • Better integration for automated Backups
  • More Installation Methods

License

This project is licensed under the MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

backuparr-0.2.2.tar.gz (9.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

backuparr-0.2.2-py3-none-any.whl (10.4 kB view details)

Uploaded Python 3

File details

Details for the file backuparr-0.2.2.tar.gz.

File metadata

  • Download URL: backuparr-0.2.2.tar.gz
  • Upload date:
  • Size: 9.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for backuparr-0.2.2.tar.gz
Algorithm Hash digest
SHA256 f57c7816cc9088a8d592a835e0b80954a99a279d156bbf8ff4f7f4c9bc15f078
MD5 1947afeb40c6be8c16c8ed56c7ef6bd5
BLAKE2b-256 25a463cffff1078aadb0056893cc4a4d0dbdb2ae637585931eb670055647920b

See more details on using hashes here.

Provenance

The following attestation bundles were made for backuparr-0.2.2.tar.gz:

Publisher: build-assets.yml on DanielMayhan/BackupArr

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file backuparr-0.2.2-py3-none-any.whl.

File metadata

  • Download URL: backuparr-0.2.2-py3-none-any.whl
  • Upload date:
  • Size: 10.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for backuparr-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 42fb23b63e6a880ab792b98c470d5d8211b773345a3c902f4d965316ab70cb95
MD5 2a53df8e8039c360d3300084ebb18253
BLAKE2b-256 b4fe2fc2a251369bcaf8b4ad950848514ec6ce442a0bf588edf334053229407a

See more details on using hashes here.

Provenance

The following attestation bundles were made for backuparr-0.2.2-py3-none-any.whl:

Publisher: build-assets.yml on DanielMayhan/BackupArr

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page