Configuring AutoAdd¶
Overview¶
The AutoAdd extension monitors a list of directories and automatically adds any torrent files it finds. You can provide a regular expression (ECMAScript syntax) as well as specify save path and tags for the torrent it matches.
Enabling AutoAdd¶
{
"extensions":
{
"autoadd":
{
"enabled": true
}
}
}
Monitoring a folder¶
This shows the simplest configuration needed to monitor a folder. The default
pattern will add any files with a .torrent
extension. If you do not
specify a save path, the default save path will be used.
{
"extensions":
{
"autoadd":
{
"enabled": true,
"folders":
[
{ "path": "C:/Torrents" }
]
}
}
}
Matching with patterns¶
One of the more powerful features of AutoAdd is the ability to match torrent
files with a regular expression. You can, for example, match any Debian files
and save them to their own folder. The pattern below will match all file names
starting with debian- and ending with a .torrent extension, and save them
to C:/Downloads/Debian ISOs
.
{
"extensions":
{
"autoadd":
{
"enabled": true,
"folders":
[
{
"path": "C:/Torrents",
"pattern": "^debian-.*\\.torrent$",
"savePath": "C:/Downloads/Debian ISOs"
}
]
}
}
}
Adding tags¶
The AutoAdd extension also supports tagging torrents. Tags provide a simple categorization system for torrents, and other extensions can use tags to apply their own set of rules. The configuration below will monitor a folder and add two tags to each torrent it finds.
{
"extensions":
{
"autoadd":
{
"enabled": true,
"folders":
[
{
"path": "C:/Torrents",
"tags": [ "tag1", "tag2" ]
}
]
}
}
}
Adding a label¶
{
"extensions":
{
"autoadd":
{
"enabled": true,
"folders":
[
{
"path": "C:/Torrents",
"label": "my-awesome-label"
}
]
}
}
}
Keeping .torrent files after adding¶
When using a utility such as Ketarin or other automated software downloading utility, it may be more beneficial to keep the .torrent file in your autoadd path to prevent your software re-downloading the .torrent with every run.
{
"extensions":
{
"autoadd":
{
"enabled": true,
"folders":
[
{
"path": "C:/Torrents",
"keep": true
}
]
}
}
}