{"id":13645457,"url":"https://github.com/usb-tools/USBProxy-legacy","last_synced_at":"2025-04-21T14:31:11.509Z","repository":{"id":9569207,"uuid":"11481730","full_name":"usb-tools/USBProxy-legacy","owner":"usb-tools","description":"A proxy for USB devices, libUSB and gadgetFS - this project is unmaintained, try here: https://github.com/usb-tools/Facedancer","archived":false,"fork":false,"pushed_at":"2021-12-06T20:01:25.000Z","size":1408,"stargazers_count":432,"open_issues_count":9,"forks_count":102,"subscribers_count":48,"default_branch":"master","last_synced_at":"2024-08-02T01:25:25.958Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/usb-tools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-07-17T16:49:53.000Z","updated_at":"2024-07-25T19:54:25.000Z","dependencies_parsed_at":"2022-08-25T23:10:56.843Z","dependency_job_id":null,"html_url":"https://github.com/usb-tools/USBProxy-legacy","commit_stats":null,"previous_names":["dominicgs/usbproxy"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usb-tools%2FUSBProxy-legacy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usb-tools%2FUSBProxy-legacy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usb-tools%2FUSBProxy-legacy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usb-tools%2FUSBProxy-legacy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/usb-tools","download_url":"https://codeload.github.com/usb-tools/USBProxy-legacy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223868240,"owners_count":17217053,"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-08-02T01:02:35.451Z","updated_at":"2024-11-09T18:31:27.740Z","avatar_url":"https://github.com/usb-tools.png","language":"C++","funding_links":[],"categories":["C++","\u003ca id=\"d03d494700077f6a65092985c06bf8e8\"\u003e\u003c/a\u003e工具"],"sub_categories":["\u003ca id=\"0ff94312f3ab4898f5996725133ea9d1\"\u003e\u003c/a\u003e未分类"],"readme":"USBProxy\n========\n\nStatus\n------\nThis project is in the very early stages (alpha), it should be assumed that it\nis currently non-functional. In fact, there are many occasions on which git\nhead doesn't even compile.\n\nTo keep up to date with the project you can join the mailing list at\nhttp://www.freelists.org/list/usbproxy or join us on IRC (#usbproxy on Freenode).\nBuild\n-----\nDependencies:\n```\nsudo apt-get install build-essential cmake\n```\nBuild:\n```\nmkdir src/build\ncd src/build\ncmake ..\nmake\nsudo make install\nsudo ldconfig\n```\n\nIf you want to try out the PCAP logger you will need to install libPCAP\nheaders:\n```\nsudo apt-get install libpcap-dev\n```\n\nRunning the tool\n----------------\nThe best way to get started with USBProxy is by trying it out. Connect a device\nto your single board computer and connect it to a target host system. Then try \nrunning the following to view packets in real time as they are sent between your\ndevice and host.\n```\nusb-mitm -l\n```\n\nIf you have a USB keyboard, try running the following to act as a keylogger:\n```\nusb-mitm -k\n```\n\nWhat?\n-----\nA USB man in the middle device using embedded Linux devices with on the go\ncontrollers.\n\nWhy?\n----\nOther USB sniffers exist, but I really like cheap ARM Linux hardware platforms\nand I wanted to tinker with the USB device side.  There was also an article on\nHack a Day about sniffing USB with the BeagleBoard-xM, but on further \ninspection, it would only build against a relatively old kernel version.\n\nToDo\n----\n * Support alternative chipsets - gadgetfs should take care of this (ish)\n * Clean up code - check return values, etc\n\nLicense\n-------\nUnless explicitly stated otherwise, all code in this repository is released\nunder the GPL v2 license, a copy of which can be found in the LICENSE file. All\nfiles that are released under a different license contain a copy of that license\nin the file.\n\nFAQ\n---\nQ. I need support!\n\nA. Me too buddy, me too.  Let's hug it out.  Your best chance of getting\nsupport is to contact me on IRC (#USBProxy on freenode.net), raise an issue on\nGitHub or join the mailing list (http://www.freelists.org/list/usbproxy).\n\nQ. How is this different to using usbmon on the host?\n\nA. It isn't.  Although there are situations where you may not be able to access\nthe code running on the host system; for example, when reverse engineering USB\ndevices for use with closed platforms.\n\nQ. Isn't the Beagle already a USB monitor?\n\nA. Initially the BeagleBone Black was intended target device for this software,\nbut almost any Linux host with both a device and host port will do. The Total \nPhase Beagle USB monitors are excellent devices for sniffing and debugging USB\nconnections, in fact, one was used by \"AlexP\" to reverse engineer the Microsoft\nKinect.  However, they are completely unrelated to the BeagleBone Black devices\nproduced by TI, which are open source single board computer systems.  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fusb-tools%2FUSBProxy-legacy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fusb-tools%2FUSBProxy-legacy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fusb-tools%2FUSBProxy-legacy/lists"}