====== Transmission ======

===== Install =====
<code>
sudo apt-get install transmission-daemon
sudo service transmission-daemon stop
sudo vi /var/lib/transmission-daemon/info/settings.json
#change rcp username and password (the password can be plaintext, next restart it'll be replaced with sha1 format)
#add local network to rcp whitelist like 127.0.0.1,192.168.1.*
#set "incomplete-dir": "/var/lib/transmission-daemon/downloads",
#set "incomplete-dir-enabled": true,
#set umask to 2
#default torrent folder is /var/lib/transmission-daemon/downloads. place torrent in there and it will start downloading.
sudo usermod -a -G debian-transmission wuff
sudo usermod -a -G users debian-transmission

#increase UDP buffers for uTP support
sudo vi /etc/sysctl.conf
add 
#UDP buffer increase for Transmission uTP support
net.core.rmem_max = 16777216
net.core.wmem_max = 4194304

#then 
sudo sysctl -p

sudo service transmission-daemon start
#default web interface is http://server-ip:9091
</code>
Firefox addon for adding magnet links/bt to remote transmission:\\
https://addons.mozilla.org/en-US/firefox/addon/transmitter-for-transmission/?src=ss


<code>
sudo apt-get install smbclient
sudo apt-get install cifs-utils

# if wifi/bluetooth is required only:
sudo apt-get install wpasupplicant wireless-tools
####Be VERY careful with the following command and only install connman if you really need it. Connman takes over default Linux network and wifi connection settings and results in a very hard time to configure it yourself and might even result in network not to work as it's supposed to!
sudo apt-get install connman
connmanctl enable bluetooth 
hciconfig hci0 up
</code>


===== Firefox addon for remote magnet links =====


Firefox addon to add magnet/torrent links to transmission web server:
https://addons.mozilla.org/en-GB/firefox/addon/transmitter-for-transmission/?src=search
https://addons.mozilla.org/en-GB/firefox/addon/magnet-link-to-transmission/

https://forum.transmissionbt.com/viewtopic.php?p=67122#p67122

===== Python script for magnet links =====


Python script for adding magnet links:
<code python>
#!/usr/bin/python3
#
# Simple magnet link uploader
#
# Needs httplib2: http://code.google.com/p/httplib2/
#

import httplib2
from sys import argv, exit
from json import dumps

# is magnet link given in command line?
if len(argv) < 2: 
    print('Usage: magnet-handler.py "magnet link"')
    exit(1)

# Replace hostname, transmission-username and transmission-password
url = 'http://hostname:9091/transmission/rpc'
username = 'transmission-username'
password = 'transmission-password'

h = httplib2.Http(".cache")
h.add_credentials(username, password)
resp, content = h.request(url, "GET")

headers = { "X-Transmission-Session-Id": resp['x-transmission-session-id'] }
body = dumps( { "method": "torrent-add",
                "arguments": { "filename": argv[1] } } )

response, content = h.request(url, 'POST', headers=headers, body=body)

if str(content).find("success") == -1:
    print("Magnet Link: " + argv[1])
    print("Answer: " + content)
    print("No 'success' here!")
    print("Press Enter to Exit.")
    input()
</code>


Python script for adding magnet links with notification (windows):
<code python>
#!/usr/bin/python3
#
# Transmission magnet link uploader
# (https cert check disabled)
#
# Uses requests & PyQt5
# http://docs.python-requests.org/en/latest/
# http://www.riverbankcomputing.co.uk/software/pyqt/download5
#

# Standard
from json import dumps
from sys import argv, exit
from urllib.parse import unquote

# 3rd Party
import requests
from PyQt5.QtCore import QTimer
from PyQt5.QtGui import QIcon
from PyQt5.QtWidgets import (QApplication, QMessageBox, QSystemTrayIcon)

# Settings
url = 'https://address.domain:port/transmission/rpc'
username = 'transmission'
password = 'secret'
icon = 'C:\\Icons\\Magnet-icon.png'

# Functions

# Show Message Box
def show_message(title, message):
    app = QApplication([])
    QMessageBox.information(None, title, message)

# Show Tray Message
def show_tray_message(title, message):
    app = QApplication([])
    trayIcon = QSystemTrayIcon(QIcon(icon), app)
    trayIcon.show()
    trayIcon.showMessage(title, message, QSystemTrayIcon.Information)
    QTimer.singleShot(8000, app.quit)
    app.exec_()

# Get RPC Session ID
def get_session_id():
    sessionid_request = requests.get(url, auth=(username, password), verify=False)
    return sessionid_request.headers['x-transmission-session-id']

# Post Magnet Link
def post_link(magnetlink):
    sessionid = get_session_id()
    if sessionid:
        headers = {"X-Transmission-Session-Id": sessionid}
        body = dumps({"method": "torrent-add", "arguments": {"filename": magnetlink}})
        post_request = requests.post(url, data=body, headers=headers, auth=(username, password), verify=False)
        if str(post_request.text).find("success") == -1:
            title =  argv[0] + ' - Error'
            message = 'Magnet Link: ' + magnetlink + '\nAnswer: ' + post_request.text
            show_message(title, message)
        else:
            message = '\n'.join(names) + '\n' + '\n'.join(trackers)
            show_tray_message('Magnet Link Added', message)

# End of Functions

# Main prog
if __name__ == '__main__':

    # Check Argument and Extract Name/Trackers or Display Alert Message
    if len(argv) < 2:
        show_message(argv[0] + ' - Alert', 'Usage: ' + argv[0] + ' [magnet link]')
        exit(1)
    elif argv[1].startswith('magnet'):
        names = []
        trackers = []
        for item in argv[1].split('&'):
            decoded = unquote(item)
            if decoded.startswith('dn='):
                names.append(decoded.replace('dn=', ''))
            if decoded.startswith('tr='):
                trackers.append(decoded.replace('tr=', ''))
    else:
        show_message(argv[0] + ' - Alert', argv[1] + ' not magnet link!')
        exit(1)
    
    post_link(argv[1])
</code>

===== Re-add failed torrents =====

Store all current torrents in csv file, then prompt for confirmation for each failed torrent to remove it with data and re-submit it to transmission.

<code>
pip install transmissionrpc
</code>

<code python transmission-readd-failed.py>
#!/bin/python
import transmissionrpc
import csv

# Connect to Transmission server with authentication
tc = transmissionrpc.Client('192.168.1.2', port=9091, user='synbt', password='synbt')

# Retrieve list of torrents with error messages
torrents = tc.get_torrents(arguments=['id', 'name', 'status', 'progress', 'magnetLink', 'errorString'])
torrents_with_errors = [t for t in torrents if t.errorString != '']

# Iterate over each torrent with errors
for torrent in torrents_with_errors:
    # Output the torrent information
    print(f"Name: {torrent.name}\nError: {torrent.errorString}")

    # Ask for confirmation to delete and re-add the torrent
    confirmation = input("Delete and re-add this torrent? (y/n): ").strip().lower()
    if confirmation == 'y':
        # Delete the torrent and re-add it with the magnet link
        tc.remove_torrent(torrent.id, delete_data=True)
        tc.add_torrent(torrent.magnetLink)
        print(f"{torrent.name} has been deleted and re-added.")
    else:
        print(f"{torrent.name} will not be deleted and re-added.")

# Output the torrent information to a CSV file
with open('torrent_info.csv', 'w', newline='') as csvfile:
    fieldnames = ['id', 'name', 'magnet', 'error']
    writer = csv.DictWriter(csvfile, fieldnames=fieldnames)
    writer.writeheader()
    for torrent in torrents_with_errors:
        writer.writerow({'id': torrent.id, 'name': torrent.name, 'magnet': torrent.magnetLink, 'error': torrent.errorString})
</code>