summarylogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authoraetherised2021-05-11 02:31:18 -0400
committeraetherised2021-05-11 02:31:18 -0400
commit47f001bfb2af09cbaa1e3077a1971a3d61ccd066 (patch)
treefd2b32cfed9333d8fe3cea9dfcfc46527863292e /README.md
downloadaur-addmag.tar.gz
init
Diffstat (limited to 'README.md')
-rw-r--r--README.md30
1 files changed, 30 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 00000000000..e333e93b000
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+**A simple tool to open magnet links** using a remote
+[Transmission](https://github.com/transmission/transmission) daemon. Includes
+a `.desktop` file for use with `xdg-open`. The remote server address is
+configurable on a system-wide and per-user basis.
+
+Requires that `transmission-remote` be available on the system. Includes
+PKGBUILD for installation on Arch. Under Arch, `transmission-remote` is found in
+the `transmission-cli` package.
+
+# USAGE
+
+**`addmag LINK`** where `LINK` is a magnet link or path to a torrent file
+
+# CONFIGURATION
+
+**`addmag`** looks for configuration files in the following locations:
+
+* `/etc/addmagrc`
+* `~/.addmagrc`
+
+These files should contain the address of the server running the Transmission
+daemon and nothing else. Per-user configutation (in `~/.addmagrc`) overrides
+the system configuration (in `/etc/addmagrc`).
+
+# LICENSE & COPYRIGHT
+
+Available under the terms of the **MIT license**. See included LICENSE file for
+the full text of the lisence.
+
+Copyright 2021 **aetherised** <<aetherised@gmail.com>>