File: rip.adoc

package info (click to toggle)
streamrip 2.1.0-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 2,560 kB
  • sloc: python: 6,308; makefile: 5
file content (105 lines) | stat: -rw-r--r-- 2,221 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
= rip(1)
Dr. Tobias Quathamer
:doctype: manpage
:docdate: 2025-12-15
:manversion: 2.1.0
:mansource: 2.1.0
:!author:

== Name

rip - the all in one music downloader

== Synopsis

*rip* [_OPTIONS_] _COMMAND_ [_ARGS_] …

== Description

This manual page documents briefly the *rip* command.
It can be used to download music from various streaming
services.

== Options

This program follows the usual GNU command line syntax, with long options
starting with two dashes ('*-*'). *rip* supports the following options:

*--version*::
  Show the version and exit.
*--config-path* _PATH_::
  Path to the configuration file
*-f, --folder* _DIRECTORY_::
  The folder to download items into.
*-ndb, --no-db*::
  Download items even if they have been logged in the database
*-q, --quality* _QUALITY::
  The maximum quality allowed to download [0<=x<=4]
*-c, --codec* _CODEC_::
  Convert the downloaded files to an audio codec (ALAC, FLAC, MP3, AAC,
  or OGG)
*--no-progress*::
  Do not show progress bars
*--no-ssl-verify*::
  Disable SSL certificate verification (use if you encounter SSL errors)
*-v, --verbose*::
  Enable verbose output (debug mode)
*--help*::
  Show this message and exit.

== Commands

config::
  Manage configuration files.
database::
  View and modify the downloads and failed downloads databases.
file::
  Download content from URLs in a file.
id::
  Download an item by ID.
lastfm::
  Download tracks from a last.fm playlist.
search::
  Search for content using a specific source.
url::
  Download content from URLs.

== Examples

=== Quality/Format Conversion
----
rip -q 4 -c FLAC url https://tidal.com/album/123  # Best quality FLAC
rip -q 2 -c MP3 search deezer track "Dance Song" # 320kbps MP3
----

=== Headless Operation
----
rip --no-progress -f file batch.txt  # Silent batch processing
----

=== Debugging
----
rip -v --no-ssl-verify url https://problematic.url  # Debug SSL issues
----

== Exit codes

*0*::
  Success
*1*::
  General error
*2*::
  Invalid arguments
*3*::
  Config error
*4*::
  Network error
*5*::
  Authentication failure

== Author

*rip* was written by Nathan Thomas.

This manual page was written by Dr. Tobias Quathamer for
the Debian project (but may be used by others).