gpodder-backup(1) - Linux man page

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)