# # This file is part of FreedomBox. # # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU Affero General Public License as # published by the Free Software Foundation, either version 3 of the # License, or (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Affero General Public License for more details. # # You should have received a copy of the GNU Affero General Public License # along with this program. If not, see . # """ FreedomBox app to configure Transmission server. """ import json from django.utils.translation import ugettext_lazy as _ from plinth import service as service_module from plinth import action_utils, actions, frontpage from plinth.menu import main_menu from plinth.modules.users import register_group from .manifest import clients version = 2 managed_services = ['transmission-daemon'] managed_packages = ['transmission-daemon'] name = _('Transmission') short_description = _('BitTorrent Web Client') description = [ _('BitTorrent is a peer-to-peer file sharing protocol. ' 'Transmission daemon handles Bitorrent file sharing. Note that ' 'BitTorrent is not anonymous.'), _('Access the web interface at /transmission.') ] clients = clients reserved_usernames = ['debian-transmission'] group = ('bit-torrent', _('Download files using BitTorrent applications')) service = None manual_page = 'Transmission' def init(): """Intialize the Transmission module.""" menu = main_menu.get('apps') menu.add_urlname(name, 'glyphicon-save', 'transmission:index', short_description) register_group(group) global service setup_helper = globals()['setup_helper'] if setup_helper.get_state() != 'needs-setup': service = service_module.Service(managed_services[0], name, ports=[ 'http', 'https' ], is_external=True, is_enabled=is_enabled, enable=enable, disable=disable) if is_enabled(): add_shortcut() def setup(helper, old_version=None): """Install and configure the module.""" helper.install(managed_packages) new_configuration = { 'rpc-whitelist-enabled': False, 'rpc-authentication-required': False } helper.call('post', actions.superuser_run, 'transmission', ['merge-configuration'], input=json.dumps(new_configuration).encode()) helper.call('post', actions.superuser_run, 'transmission', ['enable']) global service if service is None: service = service_module.Service(managed_services[0], name, ports=[ 'http', 'https' ], is_external=True, is_enabled=is_enabled, enable=enable, disable=disable) helper.call('post', service.notify_enabled, None, True) helper.call('post', add_shortcut) def add_shortcut(): frontpage.add_shortcut('transmission', name, short_description=short_description, url='/transmission', login_required=True) def is_enabled(): """Return whether the module is enabled.""" return (action_utils.service_is_enabled('transmission-daemon') and action_utils.webserver_is_enabled('transmission-plinth')) def enable(): """Enable the module.""" actions.superuser_run('transmission', ['enable']) add_shortcut() def disable(): """Enable the module.""" actions.superuser_run('transmission', ['disable']) frontpage.remove_shortcut('transmission') def diagnose(): """Run diagnostics and return the results.""" results = [] results.append(action_utils.diagnose_port_listening(9091, 'tcp4')) results.append(action_utils.diagnose_port_listening(9091, 'tcp6')) results.extend( action_utils.diagnose_url_on_all('https://{host}/transmission', check_certificate=False)) return results