---
name: "gpodder-backup"
section: "1"
platform: "linux"
package: "gpodder"
version: "2.20.1-1"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/gpodder-backup"
---

# gpodder-backup(1)

Backup and restore utility for gPodder user data

## NAME

gpodder-backup - Backup and restore utility for gPodder user data

## SYNOPSIS

**gpodder-backup** \[*--create\|--extract*\] *\<archive.gpo.tar.gz\>* \[*options*\] **gpodder-backup** *--purge*

## DESCRIPTION

This utility can be used to create a dump of the current gPodder data (configuration files + downloads), optionally replacing the real contents of the download folder with zero-byte files (for submitting your data to a bug report without having to transfer lots of data).

## OPTIONS

- **--version**

  show program's version number and exit

- **-h**, **--help**

  show this help message and exit

- **-c** \<FILE\>, **--create=**\<FILE\>

  Create a new archive

- **-x** \<FILE\>, **--extract=**\<FILE\>

  Extract an existing archive

- **-f**, **--fake-downloads**

  Store downloads as zero-byte files in backup

- **-n**, **--no-covers**

  Do not include cover files in archive

- **-D** \<DIR\>, **--destination=**\<DIR\>

  Extract downloads in different folder

- **-P**, **--purge**

  Remove current data (can be combined with --extract)

## USAGE FOR BUG REPORTING

- This command is useful if you want to report a bug in gPodder:

  - **gpodder-backup --create bug123.gpo.tar.gz --fake-downloads**

  Backup your current data to file *bug123.gpo.tar.gz*, but don't store download data (create zero-size dummy files instead). You can then attach *bug123.gpo.tar.gz* to the bug report.

- If you are instructed to try gPodder from a "clean state", you can use the following command (be sure to backup your data before!):

  - **gpodder-backup --purge**

  Remove all gPodder data, so you can start from a clean state

## EXAMPLES

- **gpodder-backup --create today.gpo.tar.gz**

  Backup your current data to file *today.gpo.tar.gz*

- **gpodder-backup --extract mybackup.gpo.tar.gz**

  Restore (without purging) the contents of *mybackup.gpo.tar.gz*

- **gpodder-backup --extract default.gpo.tar.gz --purge**

  Remove current data, then restore the contents of *default.gpo.tar.gz*

- **gpodder-backup --purge**

  Remove all gPodder data, so you can start from a clean state

## EXTRACTING FAKED DOWNLOADS

Please note that any existing downloads will be overwritten with zero-byte files when using the **--extract** option of the gpodder-backup utility with a backup created with **--fake-downloads**

## AUTHOR

gpodder-backup was written by Thomas Perl (thp@gpodder.org)