mirror of
https://codeberg.org/scip/kleingebaeck.git
synced 2025-12-16 20:11:01 +01:00
Thomas von Dein
1b55d887bc
- english README (german version will be put to the homepage) - better commandline options - enhanced logging capabilities and error handling - config file support - support to backup one or more singular ads - add id to adlisting - added manual page - fixed config file reading - fixed typo
83 lines
2.3 KiB
Plaintext
83 lines
2.3 KiB
Plaintext
=head1 NAME
|
|
|
|
kleingebaeck - kleinanzeigen.de backup tool
|
|
|
|
=head1 SYNOPSYS
|
|
|
|
This is kleingebaeck, the kleinanzeigen.de backup tool.
|
|
Usage: kleingebaeck [-dvVhmoc] [<ad-listing-url>,...]
|
|
Options:
|
|
--user,-u <uid> Backup ads from user with uid <uid>.
|
|
--debug, -d Enable debug output.
|
|
--verbose,-v Enable verbose output.
|
|
--output-dir,-o <dir> Set output dir (default: current directory)
|
|
--manual,-m Show manual.
|
|
--config,-c <file> Use config file <file> (default: ~/.kleingebaeck).
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
This tool can be used to backup ads on the german ad page L<https://kleinanzeigen.de>.
|
|
|
|
It downloads all (or only the specified ones) ads of one user into a
|
|
directory, each ad into its own subdirectory. The backup will contain
|
|
a textfile B<Adlisting.txt> which contains the ad contents such as
|
|
title, body, price etc. All images will be downloaded as well.
|
|
|
|
=head1 CONFIGURATION
|
|
|
|
You can create a config file to save typing. By default
|
|
C<~/.kleingebaeck.hcl> is being used but you can specify one with
|
|
C<-c> as well.
|
|
|
|
Format is simple:
|
|
|
|
user = 1010101
|
|
verbose = true
|
|
outdir = "test"
|
|
|
|
=head1 SETUP
|
|
|
|
To setup the tool, you need to lookup your userid on
|
|
kleinanzeigen.de. Go to your ad overview page while NOT being logged
|
|
in:
|
|
|
|
https://www.kleinanzeigen.de/s-bestandsliste.html?userId=XXXXXX
|
|
|
|
The B<XXXXX> part is your userid.
|
|
|
|
Put it into the configfile as outlined above. Also specify an output
|
|
directory. Then just execute C<kleingebaeck>.
|
|
|
|
You can use the B<-v> option to get verbose output or B<-d> to enable
|
|
debugging.
|
|
|
|
=head1 BUGS
|
|
|
|
In order to report a bug, unexpected behavior, feature requests
|
|
or to submit a patch, please open an issue on github:
|
|
L<https://github.com/TLINDEN/kleingebaeck/issues>.
|
|
|
|
Please repeat the failing command with debugging enabled C<-d> and
|
|
include the output in the issue.
|
|
|
|
=head1 LIMITATIONS
|
|
|
|
The C<kleingebaeck> doesn't currently check if it has downloaded a
|
|
file already, so it downloads everything again every time you execute
|
|
it. Be aware of it. This will change in the future.
|
|
|
|
Also there's currently no parallelization implemented. This will
|
|
change in the future.
|
|
|
|
=head1 LICENSE
|
|
|
|
Licensed under the GNU GENERAL PUBLIC LICENSE version 3.
|
|
|
|
=head1 Author
|
|
|
|
T.v.Dein <tom AT vondein DOT org>
|
|
|
|
|
|
|
|
=cut
|