Skip to content

Commit cb3ea08

Browse files
authored
feat(docs): versioning (autobrr#127)
* prepare all links for versioning * feat(docs): add versioning
1 parent 03b8740 commit cb3ea08

24 files changed

+457
-211
lines changed

docs/configuration/autobrr.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -109,10 +109,10 @@ autobrrctl --config ~/.config/autobrr create-user USERNAME
109109

110110
Make sure to read through all of the articles as all of them have some important information on how to get autobrr up and running.
111111

112-
- [Indexers <CgWebsite />](/configuration/indexers)
113-
- [IRC <BsChatDotsFill />](/configuration/irc)
114-
- [Download Clients <FaDownload />](/configuration/download-clients/dedicated)
115-
- [Feeds (RSS / Torznab / Newznab) <MdRssFeed />](/configuration/feeds)
112+
- [Indexers <CgWebsite />](./indexers.md)
113+
- [IRC <BsChatDotsFill />](./irc.md)
114+
- [Download Clients <FaDownload />](./download-clients/dedi.md)
115+
- [Feeds (RSS / Torznab / Newznab) <MdRssFeed />](./feeds.md)
116116

117117
## Additional help
118118

docs/configuration/download-clients/dedi.md

+3-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2+
id: dedi
23
sidebar_label: Dedicated servers
3-
slug: /configuration/download-clients/dedicated
44
title: Download Clients
55
description: A guide on how to set up download clients in autobrr.
66
keywords:
@@ -262,6 +262,7 @@ For a local client, meaning autobrr and Sabnzbd **on the same server** then this
262262
- Host: `http://127.0.0.1:SABNZBD_PORT`
263263
- TLS: disabled
264264
- API key
265+
265266
### Remote {#sabnzbd-remote}
266267

267268
For a remote client, meaning autobrr and qBittorrent are **not on the same server** then things might be a bit different.
@@ -275,6 +276,7 @@ Some setups like **Swizzin** requires to also use **Basic Auth** when connecting
275276
- Basic Auth: enabled
276277
- Username: `<username>`
277278
- Password: `<password>`
279+
278280
## Sonarr
279281

280282
You can run autobrr and Sonarr apps on the following setups.

docs/configuration/download-clients/shared.md

-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
---
22
id: shared
3-
slug: /configuration/download-clients/shared-seedboxes
43
sidebar_label: Shared seedboxes
54
#sidebar_position: 3
65
title: Connecting to download clients on a shared seedbox

docs/configuration/indexers.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -53,14 +53,14 @@ If you want more indexers added please create an [Indexer Request](https://githu
5353

5454
For example, torrentleech provides their users with [this](http://wiki.torrentleech.org/doku.php/autobrr) page.
5555

56-
- If NickServ Password is marked `*` as required, then you need to have a registered account on that IRC network. See [registering with NickServ](/configuration/irc#registering-with-nickserv).
56+
- If NickServ Password is marked `*` as required, then you need to have a registered account on that IRC network. See [registering with NickServ](irc.md#registering-with-nickserv).
5757
- If NickServ Account is marked `*` as required, that's only used as nick, but supports NickServ auth.
5858
- The invite command field in `Settings > IRC > Edit network` are pre filled, but you need to add your IRC key. The rest should be left as is.
5959

6060
1. After the indexer is set up, head to `Settings > IRC` and click the 3 dots for the newly created network, hit `Edit`, and then enable the network. This is a good time to look over everything. The invite command etc.
6161

6262
:::caution Important
63-
Please check the [IRC](/configuration/irc) section for more details regarding NickServ, IRC keys, and grouping of nicks.
63+
Please check the [IRC](../configuration/irc.md) section for more details regarding NickServ, IRC keys, and grouping of nicks.
6464
:::
6565

6666
<IpApproval/>

docs/configuration/irc.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,7 @@ You shouldn't need to worry about it, but it's nice now to know what you need to
8686

8787
## Setup
8888

89-
The initial setup of IRC networks and channels are done during the setup of [indexers](/configuration/indexers).
89+
The initial setup of IRC networks and channels are done during the setup of [indexers](../configuration/indexers.md).
9090

9191
If you for some reason need to setup a network manually, or edit an existing one, you can do that in `Settings > IRC`.
9292

@@ -165,7 +165,7 @@ You may need to enable some modules for the network based on the networks setup.
165165

166166
#### Enabling SSL
167167

168-
While this is not required, it might be easier to get going than you think. This section is based on already having Linuxserver´s SWAG generating a certificate for `znc.mydomain.com`, while keeping all traffic between containers inside the same docker network.
168+
While this is not required, it might be easier to get going than you think. This section is based on already having Linuxserver´s SWAG generating a certificate for `znc.mydomain.com`, while keeping all traffic between containers inside the same docker network.
169169

170170
There is two changes that need to be done to the compose example to allow this to work.
171171

docs/faqs.md

+7-7
Original file line numberDiff line numberDiff line change
@@ -80,14 +80,14 @@ With TorrentLeech as an example, only add the red part when setting up your inde
8080

8181
`https://rss.tl.org/`<Highlight color="#ff2754">1812u12urr1203j12jeq</Highlight>
8282

83-
In case you are still having troubles with setting up the TorrentLeech indexer,
83+
In case you are still having troubles with setting up the TorrentLeech indexer,
8484
you can find detailed instructions for the setup process on their wiki:
8585

8686
https://wiki.torrentleech.org/doku.php/autobrr
8787

8888
## I have set up an indexer, but it does not connect to the #announce channel. What do I do?
8989

90-
Make sure you have entered the necessary keys in the invite command and that your IRC user has privileges to access to the #announce channel. See [IRC setup](/configuration/irc).
90+
Make sure you have entered the necessary keys in the invite command and that your IRC user has privileges to access to the #announce channel. See [IRC setup](./configuration/irc.md).
9191

9292
import Botnaming from '/snippets/botnaming.mdx';
9393

@@ -129,11 +129,11 @@ Use the command line or an sqlite editor.
129129

130130
### CLI
131131

132-
You need the `sqlite3` package for this.
132+
You need the `sqlite3` package for this.
133133

134-
* If you are using our docker container then you can exec in and run `apk add sqlite3`.
135-
* Ubuntu: `sudo apt install sqlite3`
136-
* On other linux based systems use the package manager to install the package
134+
- If you are using our docker container then you can exec in and run `apk add sqlite3`.
135+
- Ubuntu: `sudo apt install sqlite3`
136+
- On other linux based systems use the package manager to install the package
137137

138138
`sqlite3 autobrr.db "UPDATE users SET username = 'newuser';"`
139139

@@ -149,7 +149,7 @@ Or use the gui to click edit on the `username` column of the `users` table.
149149

150150
## How can I use my freeleech tokens from RED? {#redacted-freeleech-tokens}
151151

152-
This is something a lot of users are asking for.
152+
This is something a lot of users are asking for.
153153

154154
Golden Rule 5.3 on RED:
155155

docs/filters/actions.md

+6-5
Original file line numberDiff line numberDiff line change
@@ -26,14 +26,15 @@ pagination_label: Filters - Actions
2626

2727
A configured action is what your autodl does with a successful push. You can send it any of the supported actions. Each filter supports multiple actions just incase you need to send to multiple clients, or run custom commands as well.
2828

29-
Make sure you've set up a [download client](/configuration/download-clients/dedicated) before continuing further.
29+
Make sure you've set up a [download client](../configuration/download-clients/dedi.md) before continuing further.
3030

3131
Whether you're adding, updating or removing actions on a filter, make sure to <strong>save</strong> the filter afterwards.
3232

3333
### Macros
34-
Many of the action fields have support for [macros](/filters/macros), which allow you to enhance your workflow significantly by providing custom logic/data processing to the input data provided by autobrr.
3534

36-
This [section](/filters/macros) has been moved to its own page.
35+
Many of the action fields have support for [macros](../filters/macros.md), which allow you to enhance your workflow significantly by providing custom logic/data processing to the input data provided by autobrr.
36+
37+
This [section](../filters/macros.md) has been moved to its own page.
3738

3839
## Supported actions
3940

@@ -125,7 +126,7 @@ Autobrr supports the ability to push directly to the \*arr suite of services.
125126

126127
Could be useful to do some basic filtering before sending.
127128

128-
Select the type, and then the client. Read more about setup in [download clients setup](/configuration/download-clients/dedicated).
129+
Select the type, and then the client. Read more about setup in [download clients setup](../configuration/download-clients/dedi.md).
129130

130131
Supports both local and remote instances.
131132

@@ -163,4 +164,4 @@ There is no built in native FTP upload action but you can get around this with a
163164
- Command: `scp`
164165
- Args: `{{ .TorrentPathName }} <username>@<hostname>:<destination path>`
165166

166-
![FTP/SFTP](../../static/img/SCP.png "Exec action")
167+
![FTP/SFTP](../../static//img/SCP.png "Exec action")

docs/filters/advanced.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ Not all announces category, check [this list](./categories.md) for indexer speci
5454

5555
Not supported by all indexers. Check [this list](./freeleech.md) for indexer specifics.
5656

57-
| Field | Description | Examples | Availability |
58-
| --------------------- | ------------------------------------------------------ | ------------------ | ---------------------------------------------------------------- |
59-
| **Freeleech** | Should this filter match only Freeleech releases? | | [Depends on Indexer](/filters/freeleech) |
60-
| **Freeleech Percent** | Allowed Freeleech Percentage for this filter to match. | e.g. `50%,75-100%` | [Depends on Indexer, might not use percent.](/filters/freeleech) |
57+
| Field | Description | Examples | Availability |
58+
| --------------------- | ------------------------------------------------------ | ------------------ | ------------------------------------------------------------ |
59+
| **Freeleech** | Should this filter match only Freeleech releases? | | [Depends on Indexer](./freeleech.md) |
60+
| **Freeleech Percent** | Allowed Freeleech Percentage for this filter to match. | e.g. `50%,75-100%` | [Depends on Indexer, might not use percent.](./freeleech.md) |

docs/filters/examples.md

+5-6
Original file line numberDiff line numberDiff line change
@@ -32,10 +32,10 @@ When using autobrr with Sonarr these are some good recommendation filters to sta
3232

3333
It's advisable to setup your Sonarr properly with the help of [Trash-guides](https://trash-guides.info) and then just do some light filtering of releases to not push unwanted releases to Sonarr.
3434

35-
Don't forget to add a [Sonarr action](/filters/actions#radarr-sonarr-lidarr-readarr-and-whisparr)!
35+
Don't forget to add a [Sonarr action](../filters/actions.md#radarr-sonarr-lidarr-readarr-and-whisparr)!
3636

3737
:::caution Important
38-
Not all indexers announce video **container** like `mkv` or `mp4`. It's best to leave this off.
38+
Not all indexers announce video **container** like `mkv` or `mp4`. It's best to leave this off.
3939
:::
4040

4141
### HD WEB (720p, 1080p)
@@ -48,7 +48,6 @@ Set this to match your quality settings in Sonarr
4848
| Sources | [WEB, WEB-DL, WEBRip] |
4949
| Match Categories | [Depends on Indexer](./categories.md) |
5050

51-
5251
### 4k (2160p)
5352

5453
Set this to match your quality settings in Sonarr
@@ -99,10 +98,10 @@ When using autobrr with Radarr these are some good recommendation filters to sta
9998

10099
It's advisable to setup your Radarr properly with the help of [Trash-guides](https://trash-guides.info) and then just do some light filtering of releases to not push unwanted releases to Radarr.
101100

102-
Don't forget to add a [Radarr action](/filters/actions#radarr-sonarr-lidarr-and-whisparr)!
101+
Don't forget to add a [Radarr action](./actions.md#radarr-sonarr-lidarr-readarr-and-whisparr)!
103102

104103
:::caution Important
105-
Not all indexers announce video **container** like `mkv` or `mp4`. It's best to leave this off.
104+
Not all indexers announce video **container** like `mkv` or `mp4`. It's best to leave this off.
106105
:::
107106

108107
### HD (720p, 1080p)
@@ -145,7 +144,7 @@ If you **DON'T WANT ANY HDR** formats
145144

146145
If you are in need of buffer this is an example that will work will on general indexers with freeleech/bonus systems.
147146

148-
Check your indexer or our [list of indexers supporting freeleech](/filters/freeleech) filtering for specifics.
147+
Check your indexer or our [list of indexers supporting freeleech](./freeleech.md) filtering for specifics.
149148

150149
| Field | Values |
151150
| --------- | ------------- |

docs/filters/external.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -13,13 +13,13 @@ pagination_next: filters/actions
1313

1414
With external filters you can run `scripts` and `webhooks` to do your own custom filtering. If **Expected exit status** matches it will continue. If not it stops there.
1515

16-
Many of the fields have support for [macros](/filters/macros), which allow you to enhance your workflow significantly by providing custom logic/data processing to the input data provided by autobrr.
16+
Many of the fields have support for [macros](./macros.md), which allow you to enhance your workflow significantly by providing custom logic/data processing to the input data provided by autobrr.
1717

1818
### Script
1919

2020
Run external script that does something. Use `exit codes` correctly, like `exit 0` for no issues. In Linux, non-zero exit codes are considered not-ok/error etc.
2121

22-
See [stop if disk is full](/usage/tips#stop-if-disk-is-full) for a good example of what it can do.
22+
See [stop if disk is full](../usage/tips.md#stop-if-disk-is-full) for a good example of what it can do.
2323

2424
| Field | Description | Examples |
2525
| ------------------------ | --------------------- | -------------------------------------------------------------- |

docs/filters/music.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ pagination_label: Filters - Music
99
pagination_next: filters/advanced
1010
---
1111

12-
# Filters
12+
# Music
1313

1414
:::tip
1515
You can easily convert your autodl-irssi filters into autobrr filters using our conversion tool. Visit https://convert.autobrr.com and follow the simple steps to convert each filter individually.

docs/installation/docker.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ environment:
6767
6868
### Manually configure autobrr (optional) {#manually-configure-autobrr}
6969
70-
You can either let autobrr create the config itself at startup, or create one manually. For more information, please visit [configuring autobrr](/configuration/autobrr) which covers creating a user manually, configuring the default port, setting the desired log level, etc.
70+
You can either let autobrr create the config itself at startup, or create one manually. For more information, please visit [configuring autobrr](../configuration/autobrr.md) which covers creating a user manually, configuring the default port, setting the desired log level, etc.
7171
7272
### Start the container
7373

docs/installation/linux.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Welcome to the autobrr installation walkthrough!
3030
Follow these steps and we will have you up and running in no time.
3131

3232
Follow instructions below for recommended setup on a regular Linux server.
33-
Additionally see our installation instructions for [Docker <FaDocker />](/installation/docker) and [Windows <FaWindows />](/installation/windows).
33+
Additionally see our installation instructions for [Docker <FaDocker />](./docker.md) and [Windows <FaWindows />](./windows.md).
3434

3535
import SeedboxSolutionInstallers from '/snippets/seedbox-solution-installers.mdx';
3636

@@ -59,7 +59,7 @@ sudo tar -C /usr/local/bin -xzf autobrr*.tar.gz
5959
This will extract both `autobrr` and `autobrrctl` to `/usr/local/bin`.
6060

6161
:::info
62-
If you do not have root, or are on a shared system, place the binaries somewhere in your home directory like `~/.bin` or use our installers for [shared seedboxes](/installation/shared-seedbox).
62+
If you do not have root, or are on a shared system, place the binaries somewhere in your home directory like `~/.bin` or use our installers for [shared seedboxes](../installation/shared-seedbox.md).
6363
:::
6464

6565
### Configuration
@@ -72,7 +72,7 @@ mkdir -p ~/.config/autobrr
7272

7373
#### Manually configure autobrr (optional)
7474

75-
You can either let autobrr create the config itself at startup, or create one manually. For more information, please visit [configuring autobrr](/configuration/autobrr) which covers creating a user manually, configuring the default port, setting the desired log level, etc.
75+
You can either let autobrr create the config itself at startup, or create one manually. For more information, please visit [configuring autobrr](../configuration/autobrr) which covers creating a user manually, configuring the default port, setting the desired log level, etc.
7676

7777
### Systemd (recommended)
7878

docs/installation/shared-seedbox.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -43,10 +43,10 @@ These are instructions and installation scripts for shared seedboxes. We have su
4343

4444
The scripts requires some input but does most of the work.
4545

46-
Additionally see our installation instructions for [Linux <FaLinux />](/installation/linux), [Docker <FaDocker />](/installation/docker) and [Windows <FaWindows />](/installation/windows).
46+
Additionally see our installation instructions for [Linux <FaLinux />](../installation/linux.md), [Docker <FaDocker />](../installation/docker.md) and [Windows <FaWindows />](../installation/windows.md).
4747

4848
import SeedboxInstallers from '/snippets/seedbox-installers.mdx';
4949

5050
<SeedboxInstallers />
5151

52-
Note: Remember to head over to our [Configuration Guide](/configuration/indexers) to learn how to set up your indexers, IRC, and download clients after you're done installing.
52+
Note: Remember to head over to our [Configuration Guide](../configuration/indexers.md) to learn how to set up your indexers, IRC, and download clients after you're done installing.

docs/installation/supplementary/transfer-installation.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -38,10 +38,10 @@ Now that you have successfully backed up your `autobrr.db` from your old host, y
3838

3939
Please refer to our guides or to the guides of your hosting provider on how to install autobrr on you new host:
4040

41-
- [Linux](/installation/linux)
42-
- [Docker](/installation/docker)
43-
- [Shared Seedbox](/installation/shared-seedbox)
44-
- [Windows](/installation/windows)
41+
- [Linux](../linux.md)
42+
- [Docker](../docker.md)
43+
- [Shared Seedbox](../shared-seedbox.md)
44+
- [Windows](../windows.md)
4545

4646
## Restoring your database
4747

docs/installation/windows.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ https://github.com/autobrr/autobrr/releases/latest
2525

2626
### Manually configure autobrr (optional) {#manually-configure-autobrr}
2727

28-
You can either let autobrr create the config itself at startup, or create one manually. For more information, please visit [configuring autobrr](/configuration/autobrr) which covers creating a user manually, configuring the default port, setting the desired log level, etc.
28+
You can either let autobrr create the config itself at startup, or create one manually. For more information, please visit [configuring autobrr](../configuration/autobrr.md) which covers creating a user manually, configuring the default port, setting the desired log level, etc.
2929

3030
## Create Windows task
3131

0 commit comments

Comments
 (0)