{"id":15575329,"url":"https://github.com/meejah/carml","last_synced_at":"2025-05-07T10:36:24.273Z","repository":{"id":19329051,"uuid":"22567576","full_name":"meejah/carml","owner":"meejah","description":"Command-line utility to control Tor.","archived":false,"fork":false,"pushed_at":"2023-11-28T16:17:09.000Z","size":622,"stargazers_count":89,"open_issues_count":12,"forks_count":10,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-02-18T22:08:31.001Z","etag":null,"topics":["networking","privacy","tor"],"latest_commit_sha":null,"homepage":"http://tvflhlyx7o5qsl6a2v6pvzwripzzvzgt32tkhfbys7tj3zrm4faz53yd.onion/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/meejah.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2014-08-03T04:59:40.000Z","updated_at":"2024-12-10T06:46:03.000Z","dependencies_parsed_at":"2024-06-21T15:44:33.820Z","dependency_job_id":"4369a7ed-1f9a-4223-9707-127e5fc047bf","html_url":"https://github.com/meejah/carml","commit_stats":{"total_commits":253,"total_committers":6,"mean_commits":"42.166666666666664","dds":0.08695652173913049,"last_synced_commit":"753bcbc2625dce56f0896b08e905d586f9ea9580"},"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meejah%2Fcarml","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meejah%2Fcarml/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meejah%2Fcarml/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meejah%2Fcarml/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/meejah","download_url":"https://codeload.github.com/meejah/carml/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240766621,"owners_count":19854119,"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":["networking","privacy","tor"],"created_at":"2024-10-02T18:29:11.280Z","updated_at":"2025-02-26T00:09:29.875Z","avatar_url":"https://github.com/meejah.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"carml\n=====\n\n``carml`` is a command-line tool to query and control a running Tor\n(including Tor Browser Bundle). You can do things like:\n\n * list and remove streams and circuits;\n * monitor stream, circuit and address-map events;\n * watch for any Tor event and print it (or many) out;\n * monitor bandwidth;\n * run any Tor control-protocol command;\n * pipe through common Unix tools like ``grep``, ``less``, ``cut``, etcetera;\n * download TBB through Tor, with pinned certs and signature checking;\n * ...even spit out and run ``xplanet`` configs (with router/circuit markers)!\n\nIt is written in Python and uses Tor's control-port via the `txtorcon\nlibrary \u003chttps://txtorcon.readthedocs.org\u003e`_.\n\n**Documentation at:** `carml.rtfd.org \u003chttps://carml.readthedocs.org/en/latest/\u003e`_ or `tvflhlyx7o5qsl6a2v6pvzwripzzvzgt32tkhfbys7tj3zrm4faz53yd.onion/ \u003chttp://tvflhlyx7o5qsl6a2v6pvzwripzzvzgt32tkhfbys7tj3zrm4faz53yd.onion/\u003e`_\n**Code at:** `github.com/meejah/carml \u003chttps://github.com/meejah/carml/\u003e`_\n\nIn some ways, ``carml`` started as a dumping-ground for things I\nhappened to make Tor do at least once from Python code. Are there\nthings you wish you could easily make Tor do from the command-line?\nFile an enhancement bug at GitHub!\n\n``carml`` is also easy to extend, even with system- or `virtualenv\n\u003chttp://docs.python-guide.org/en/latest/dev/virtualenvs/\u003e`_- installed\npackages.\n\nFeedback is appreciated -- pull-requests and bug-reports (including\nfeature enhancements) welcome `at GitHub\n\u003chttps://github.com/meejah/carml\u003e`_ or you can contact me in `#tor-dev\non OFTC \u003circ://irc.oftc.net/tor-dev\u003e`_ or via *meejah at meejah dot\nca* with the public-key contained in the source.\n\n\nSome Quick Examples\n-------------------\n\n.. sourcecode:: shell-session\n\n    (venv)meejah@machine:~$ carml circ --list\n    Connected to a Tor version \"0.2.4.21 (git-c5a648cc6f218339)\" (status: recommended).\n    Circuits:\n       809: BUILT 29 minutes ago carmlfake0-\u003e~Unnamed-\u003elobstertech\n       810: BUILT 29 minutes ago ~carmelfake1-\u003e~toxiroxi-\u003e~SECxFreeBSD64\n       811: BUILT 5 minutes ago carmelfake2-\u003etorpidsDEinterwerk-\u003e~rainbowwarrior\n       813: BUILT 24 seconds ago carmlfake0-\u003e~arkhaios1-\u003e~IPredator\n    (venv)meejah@machine:~$ carml circ --delete 810\n    Connected to a Tor version \"0.2.4.21 (git-c5a648cc6f218339)\" (status: recommended).\n    Deleting circuit \"810\"...\n    ...circuit 172 gone.\n    (venv)meejah@machine:~$ echo \"hello world\" | carml pastebin --once\n    12 bytes to share.\n    Launching Tor: connected.\n    People using Tor Browser Bundle can find your paste at (once the descriptor uploads):\n\n       http://ok2byooigb4v53be.onion\n\n    If you wish to keep the hidden-service keys, they're in (until we shut down):\n    /dev/shm/tortmp6eHPg4\n    Awaiting descriptor upload...\n    Descriptor uploaded; hidden-service should be reachable.\n    Mon Jul 21 13:54:38 2014: Serving request to User-Agent \"curl/7.37.0\".\n    Shutting down.\n    (venv3)meejah@machine:~$ carml tbb\n    Getting recommended versions from \"http://2gzyxa5ihm7nsggfxnu52rck2vv4rvmdlkiu3zzui5du4xyclen53wid.onion/projects/torbrowser/RecommendedTBBVersions\".\n       7.5.5, 7.5.5-MacOS, 7.5.5-Linux, 7.5.5-Windows, 7.5.6, 7.5.6-MacOS,\n       7.5.6-Linux, 7.5.6-Windows, 8.0a8, 8.0a8-MacOS, 8.0a8-Linux,\n       8.0a8-Windows, 8.0a9, 8.0a9-MacOS, 8.0a9-Linux, 8.0a9-Windows\n    Note: there are alpha versions available; use --alpha to download.\n    Downloading \"tor-browser-linux64-7.5.5_en-US.tar.xz.asc\" from:\n        http://scpalcwstkydpa3y7dbpkjs2dtr7zvtvdbyj3dqwkucfrwyixcl5ptqd.onion/torbrowser/7.5.5/tor-browser-linux64-7.5.5_en-US.tar.xz.asc\n    Downloading \"tor-browser-linux64-7.5.5_en-US.tar.xz\" from:\n        http://scpalcwstkydpa3y7dbpkjs2dtr7zvtvdbyj3dqwkucfrwyixcl5ptqd.onion/torbrowser/7.5.5/tor-browser-linux64-7.5.5_en-US.tar.xz\n    [▏    ] - 0.0 of 65.8 MiB (1s remaining)\n    [▋    ] - 6.6 of 65.8 MiB (153s remaining)\n    [█▏   ] - 13.2 of 65.8 MiB (137s remaining)\n    [█▋   ] - 19.8 of 65.8 MiB (120s remaining)\n    [██▏  ] - 26.4 of 65.8 MiB (102s remaining)\n    [██▋  ] - 32.9 of 65.8 MiB (85s remaining)\n    [███▏ ] - 39.5 of 65.8 MiB (70s remaining)\n    [███▋ ] - 46.1 of 65.8 MiB (55s remaining)\n    [████▏] - 52.7 of 65.8 MiB (38s remaining)\n    [████▋] - 59.3 of 65.8 MiB (19s remaining)\n    [█████] - 65.8 of 65.8 MiB (0s remaining)\n    0.32 MiB/s\n    gpg: assuming signed data in 'tor-browser-linux64-7.5.5_en-US.tar.xz'\n    gpg: Signature made Sat 09 Jun 2018 06:42:37 AM MDT\n    gpg:                using RSA key D1483FA6C3C07136\n    gpg: Good signature from \"Tor Browser Developers (signing key) \u003ctorbrowser@torproject.org\u003e\" [unknown]\n    gpg: WARNING: This key is not certified with a trusted signature!\n    gpg:          There is no indication that the signature belongs to the owner.\n    Primary key fingerprint: EF6E 286D DA85 EA2A 4BA7  DE68 4E2C 6E87 9329 8290\n         Subkey fingerprint: A430 0A6B C93C 0877 A445  1486 D148 3FA6 C3C0 7136\n    Signature is good.\n    Extracting \"tor-browser-linux64-7.5.5_en-US.tar.xz\"...\n      decompressing...\n       20% extracted\n       40% extracted\n       60% extracted\n       80% extracted\n      100% extracted\n    Tor Browser Bundle downloaded and extracted.\n    running: ./tor-browser_en-US/Browser/start-tor-browser\n\n\n\nLicense\n-------\n\n``carml`` is public domain. See `unlicense.org\n\u003chttp://unlicense.org/\u003e`_ for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeejah%2Fcarml","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmeejah%2Fcarml","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeejah%2Fcarml/lists"}