{"id":24197082,"url":"https://github.com/bbjubjub2494/httpshare","last_synced_at":"2026-06-12T07:31:27.428Z","repository":{"id":115395414,"uuid":"110250280","full_name":"bbjubjub2494/httpshare","owner":"bbjubjub2494","description":"Quick and dirty file transfer utility using an ephemeral HTTP service","archived":false,"fork":false,"pushed_at":"2024-03-03T17:54:25.000Z","size":1531,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-24T15:08:56.462Z","etag":null,"topics":["bottlepy","filesharing","http-server","python-script"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bbjubjub2494.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2017-11-10T13:32:06.000Z","updated_at":"2022-04-19T15:24:38.000Z","dependencies_parsed_at":"2024-03-03T18:50:23.579Z","dependency_job_id":null,"html_url":"https://github.com/bbjubjub2494/httpshare","commit_stats":null,"previous_names":["bbjubjub2494/httpshare","0xbbjubjub/httpshare"],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbjubjub2494%2Fhttpshare","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbjubjub2494%2Fhttpshare/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbjubjub2494%2Fhttpshare/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbjubjub2494%2Fhttpshare/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bbjubjub2494","download_url":"https://codeload.github.com/bbjubjub2494/httpshare/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241630564,"owners_count":19993841,"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":["bottlepy","filesharing","http-server","python-script"],"created_at":"2025-01-13T19:40:46.852Z","updated_at":"2026-06-12T07:31:22.405Z","avatar_url":"https://github.com/bbjubjub2494.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"What's this?\n============\n\nAn easy-to-deploy file transfer tool.  The only requirements are:\n\n* both devices must be connected on the same local network,\n\n* One has a Python interpreter,\n\n* The other has a web browser.\n\n.. figure:: static/demo1.png\n   :target: demo1_transcript_\n   :alt:\n     Screenshot of httpshare in a vanilla Ubuntu terminal.\n     (follow link for transcript)\n\n   httpshare displaying a QR code as it starts.\n\n\n.. figure:: static/demo2.png\n   :target: demo2_transcript_\n   :alt:\n     Screenshot of the homepage of httpshare's ephemeral site.\n     (follow link for transcript)\n\n   The resulting service in Firefox Mobile.\n\nUsage\n=====\nMake sure you have a Python interpreter set up.\nIt doesn't matter if it's 2.7 or 3+.\nThen, head to the releases_ page and pick the most recent.\n(Or see Distribution_ for more alternatives.)\nFinally, run it in a terminal.\nIt doesn't need setup or unpacking, it's a self-contained `Python ZIP application`_.\n\nWhen launched, unless a network address was specified on the command-line, httpshare learns its address by connecting to a widely available web site. (http://github.com/)\nThis is reasonably likely to be the correct setting in common scenarios since most networks nowadays are primarily meant to provide access to the internet.\nOnce this is done, it starts listening on an ephemeral port and prints an URL to help the other device (*the guest*) connect.\nThe URL is supplemented by an equivalent QR code.\nOnce it connects, the guest can control httpshare by interacting with the web pages that it serves.\nThis enables file transfer in both directions.\nWhen the guest performs a file upload, manual confirmation will be required on the host.\n\n.. _releases: https://github.com/bbjubjub2494/httpshare/releases\n.. _Python ZIP application: https://docs.python.org/3/library/zipapp.html#the-python-zip-application-archive-format\n\nLimitations\n===========\nhttpshare is not designed to protect any data against a hostile third party accessing the same local network.\nIt's perfectly possible that such an attacker could copy or alter the contents of the files being exchanged.\nIf available, use more robust file-sharing methods.\nAlso consider encrypting and/or authenticating data using separate tools.\nUsing httpshare ideally shouldn't open the host to remote code execution, but no formal guarantee is made.\n\nhttpshare is single-threaded and uses synchronous IO.\nThis renders it unable to serve multiple guests simultaneously.\nHowever, it's possible to run multiple instances in parallel and assign one to each guest.\n\nDistribution\n============\nAs mentioned above, the httpshare ZIP application can be grabbed from the web.\nIt can also distribute itself through its ephemeral web site.\n(Click \"Copy\".)\nYou can still use the PGP signature found at releases_ in this case.\nPlease follow this link to `the signing key`_.\n\nA `PyPI variant`_ of this software is also available.\nIt cannot distribute itself.\n\n.. _the signing key: release_key.asc\n.. _PyPI variant: https://pypi.org/pypi/httpshare\n\nBuilding\n========\nBuilding the ZIP application is achieved simply by running the ``make_zipapp.py`` script.\nIn theory, it should produce a result that's bit-identical to the one I publish.\nThis is corroborated by building each release on Travis CI as well as on my machine.\nThe goal is to have `build reproductibility`_.\n\nhttpshare is `free software`_, released under the zlib/libpng License.\nIf you intend to distribute derivative version of this software, I would encourage using the ``PREFIX`` field in ``version.py`` to mark them as such.\n\n.. _build reproductibility: https://reproducible-builds.org/\n.. _free software: http://www.gnu.org/philosophy/free-sw.html\n\nTrivia\n======\nThe Python standard library module ``http.server`` (or ``SimpleHTTPServer`` in Python 2) offers similar functionality, but doesn't support uploading.\nThis project started with the goal of enhancing it, although it doesn't rely on code that's part of it.\n\n.. [#demo1_transcript]\n   ::\n\n    user@artfulhost:~$ httpshare --directory Pictures/\n    httpshare version 1.0.3\n\n    You can use the interrupt key (normally Control-C or Delete) to exit the program.\n\n    [[QR code]]\n    http://10.0.0.72:34575\n\n.. [#demo2_transcript]\n   ::\n\n    Welcome!\n\n    You've reached an ephemeral file sharing service launched on a computer near you. You can click on directories to browse them, click on files to download them, or use the form at the bottom to upload files.\n\n    This program: License(link) Copy(link) Development(link)\n\n    ---\n\n    (item) demo1.png(link)\n\n    ---\n\n    [[Browse] No file selected] [OK]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbjubjub2494%2Fhttpshare","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbbjubjub2494%2Fhttpshare","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbjubjub2494%2Fhttpshare/lists"}