spacemacs/layers/+tools/transmission/README.org

115 lines
5.1 KiB
Org Mode

#+TITLE: Transmission layer
#+TAGS: layer|tool
[[file:img/transmission.png]]
* Table of Contents :TOC_5_gh:noexport:
- [[#description][Description]]
- [[#features][Features:]]
- [[#install][Install]]
- [[#faq][FAQ]]
- [[#how-to-enable-status-auto-refresh][How to enable status auto refresh?]]
- [[#key-bindings][Key bindings]]
- [[#global][Global]]
- [[#transmission-mode][=transmission-mode=]]
- [[#transmission-info-mode][=transmission-info-mode=]]
- [[#transmission-files-mode][=transmission-files-mode=]]
- [[#transmission-peers-mode][=transmission-peers-mode=]]
* Description
This layer integrates a BitTorrent client into Spacemacs.
** Features:
- Integration of [[https://transmissionbt.com/][Transmission]] into emacs.
* Install
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
install and configure =transmission-daemon=. Debian example:
#+BEGIN_SRC sh
sudo apt-get -y install transmission-daemon
sudo service transmission-daemon stop
#+END_SRC
Set =rpc-authentication-required= to false (or 0 if it is numeric)
in /etc/transmission-daemon/settings.json or
configure authorization.
See transmission.el [[https://github.com/holomorph/transmission][README.org]] for details.
Start the daemon:
#+BEGIN_SRC sh
sudo service transmission-daemon start
#+END_SRC
* FAQ
** How to enable status auto refresh?
Add =(transmission :variables transmission-auto-refresh-all t)= to
=dotspacemacs-configuration-layers= or pick modes manually:
#+BEGIN_SRC emacs-lisp
(setq transmission-refresh-modes '(transmission-mode
transmission-files-mode
transmission-info-mode
transmission-peers-mode))
#+END_SRC
* Key bindings
** Global
| Key binding | Description |
|-------------+--------------------|
| ~SPC a t~ | start transmission |
** =transmission-mode=
| Key binding | Description |
|-------------+---------------------------------------------------------------|
| ~SPC m g t~ | Open a `transmission-files-mode' buffer for torrent at point. |
| ~SPC m a t~ | Add torrent by filename, URL, magnet link, or info hash. |
| ~SPC m s d~ | Set global download speed limit in kB/s. |
| ~SPC m g p~ | Open a =transmission-peers-mode= buffer for torrent at point. |
| ~SPC m g i~ | Open a =transmission-info-mode= buffer for torrent at point. |
| ~SPC m s l~ | Set global seed ratio limit. |
| ~SPC m m~ | Move torrent at point or in region to a new location. |
| ~SPC m r~ | Prompt to remove torrent at point or torrents in region. |
| ~SPC m t s~ | Toggle torrent between started and stopped. |
| ~SPC m a a~ | Add announce URLs to torrent or torrents. |
| ~SPC m s u~ | Set global upload speed limit in kB/s. |
| ~SPC m v~ | Verify torrent at point or in region. |
| ~SPC m q~ | Quit and bury the buffer. |
| ~SPC m s b~ | Set bandwidth priority of torrent(s) at point or in region. |
** =transmission-info-mode=
| Key binding | Description |
|-------------+---------------------------------------------------------------|
| ~SPC m c~ | Copy magnet link of current torrent. |
| ~SPC m s d~ | Set download limit of torrent(s) at point in kB/s. |
| ~SPC m g p~ | Open a =transmission-peers-mode= buffer for torrent at point. |
| ~SPC m s l~ | Set seed ratio limit of torrent(s) at point. |
| ~SPC m m~ | Move torrent at point or in region to a new location. |
| ~SPC m a a~ | Add announce URLs to torrent or torrents. |
| ~SPC m T~ | Remove trackers from torrent at point by ID or announce URL. |
| ~SPC m s u~ | Set upload limit of torrent(s) at point in kB/s. |
| ~SPC m s p~ | Set bandwidth priority of torrent(s) at point or in region. |
** =transmission-files-mode=
| Key binding | Description |
|-------------+---------------------------------------------------------------|
| ~SPC g f~ | Visit the file at point with =find-file-read-only=. |
| ~SPC m r~ | Run a command on the file at point. |
| ~SPC g p~ | Open a =transmission-peers-mode= buffer for torrent at point. |
| ~SPC g i~ | Open a =transmission-info-mode= buffer for torrent at point. |
| ~SPC m m~ | Move torrent at point or in region to a new location. |
| ~SPC m m u~ | Mark file(s) at point or in region as unwanted. |
| ~SPC m m w~ | Mark file(s) at point or in region as wanted. |
| ~SPC s p~ | Set bandwidth priority on file(s) at point or in region. |
** =transmission-peers-mode=
| Key binding | Description |
|-------------+--------------------------------------------------------------|
| ~SPC m g i~ | Open a =transmission-info-mode= buffer for torrent at point. |