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)