{"id":20757118,"url":"https://github.com/puhoy/bitween","last_synced_at":"2025-10-23T19:04:28.609Z","repository":{"id":79851054,"uuid":"53684407","full_name":"puhoy/bitween","owner":"puhoy","description":"a somewhat experimental xmpp/bittorrent client","archived":false,"fork":false,"pushed_at":"2016-08-25T21:24:59.000Z","size":4524,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"develop","last_synced_at":"2025-01-18T04:43:29.243Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/puhoy.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-03-11T17:28:29.000Z","updated_at":"2020-02-26T09:08:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"3727c080-35b1-4c83-9871-c19625553fc4","html_url":"https://github.com/puhoy/bitween","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/puhoy%2Fbitween","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/puhoy%2Fbitween/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/puhoy%2Fbitween/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/puhoy%2Fbitween/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/puhoy","download_url":"https://codeload.github.com/puhoy/bitween/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243066805,"owners_count":20230806,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-17T09:39:53.669Z","updated_at":"2025-10-23T19:04:28.483Z","avatar_url":"https://github.com/puhoy.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":".. image:: http://readthedocs.org/projects/bitween/badge/?version=develop\n   :target: http://bitween.readthedocs.io/en/develop/?badge=develop\n   :alt: Documentation Status\n\n.. image:: https://travis-ci.org/puhoy/bitween.svg?branch=develop\n   :target: https://travis-ci.org/puhoy/bitween\n   :alt: Build Status\n\n\n.. image:: https://coveralls.io/repos/github/puhoy/bitween/badge.svg?branch=develop\n   :target: https://coveralls.io/github/puhoy/bitween?branch=develop\n   :alt: Coverage Status\n\n\nWelcome to bitween's documentation!\n===================================\n\nBitween is a more or less experimental XMPP/BitTorrent Client i develop as part of my bachelor thesis.\n\nRight now its pretty basic and far from done.\n\n\nthings you will need\n--------------------\non ubuntu\n~~~~~~~~~\n\ntested on python2.7, could work on python3\n\nclone to where ever you like::\n\n    git clone git@github.com:puhoy/bitween.git\n\ninstall dependencies (virtualenv)::\n\n    sudo apt-get install python-libtorrent python-dev\n    cd bitween\n    virtualenv --system-site-packages -p /usr/bin/python2.7 env\n    source env/bin/activate\n    pip install -e .\n\nor install dependencies to system::\n\n    sudo apt-get install python-libtorrent python-dev\n    sudo pip install -e .\n\nconfiguring\n-----------\n\ncopy the conf.json.dist to conf.json or ~/.bitween.conf and fill in your xmpp credentials.\nthe save_path is the default save path to download to.\n\n\n.. code-block:: none\n\n    {\n      \"xmpp_account\":\n        {\n          \"jid\": \"user@domain\",\n          \"password\": \"\"\n        },\n      \"save_path\": \"share\",\n      \"enable_web_api\": true,\n      \"enable_ipv4\": true,\n      \"enable_ipv6\": true,\n      \"bt\": {\n        \"enable_upnp\": true,\n        \"enable_natpmp\": true,\n        \"ports\": [8000, 8020]\n      }\n    }\n\n\nstarting the daemon\n===================\n\n::\n\n    # (in the virtual env)\n    bitweend\n\n\nthis will start the daemon. you will have a web interface for the JSONRPC API on localhost:5000/api/browse\n\noptional::\n\n    -b '0.0.0.0'    # bind to something other than 127.0.0.1. might be useful if you want to use it on a server.\n    -p 5000         # bind the API interface to another port\n\n\nadding files to share::\n\n    bitweenc --add_path /path/to/file\n\n\nget file hashes to download::\n\n    bitweenc --list\n\nthis will list all the files you have got via xmpp, so if you have not added an account before start, nothing will be listed here.\n\n\ndownload files by hash::\n\n    bitweenc --add_hash some_sha1_hash\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpuhoy%2Fbitween","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpuhoy%2Fbitween","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpuhoy%2Fbitween/lists"}