{"id":27696252,"url":"https://github.com/penthertz/rf-swift","last_synced_at":"2026-01-29T22:06:54.268Z","repository":{"id":240391570,"uuid":"802505489","full_name":"PentHertz/RF-Swift","owner":"PentHertz","description":"🚀 A powerful multi-platform RF toolbox that deploys specialized radio tools in seconds on Linux, Windows, and macOS—supporting x86_64, ARM64 (Raspberry Pi, Apple Silicon), and RISC-V architectures without disrupting your primary OS. 📡✨","archived":false,"fork":false,"pushed_at":"2025-04-21T20:17:22.000Z","size":37007,"stargazers_count":180,"open_issues_count":1,"forks_count":9,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-25T15:08:56.446Z","etag":null,"topics":["arm64","docker","hardware","linux","pentesting","rf","risc-v","sdr","security","security-audit","security-tools","telecommunications","windows","wireless","wireless-security","x86-64"],"latest_commit_sha":null,"homepage":"https://rfswift.io/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PentHertz.png","metadata":{"files":{"readme":"README.md","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,"zenodo":null}},"created_at":"2024-05-18T13:38:03.000Z","updated_at":"2025-04-22T21:11:29.000Z","dependencies_parsed_at":"2025-04-21T21:25:14.967Z","dependency_job_id":"58770bc4-47e5-485d-8f30-de896734eea2","html_url":"https://github.com/PentHertz/RF-Swift","commit_stats":null,"previous_names":["penthertz/rf-swift"],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PentHertz%2FRF-Swift","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PentHertz%2FRF-Swift/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PentHertz%2FRF-Swift/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PentHertz%2FRF-Swift/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PentHertz","download_url":"https://codeload.github.com/PentHertz/RF-Swift/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250840609,"owners_count":21495910,"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":["arm64","docker","hardware","linux","pentesting","rf","risc-v","sdr","security","security-audit","security-tools","telecommunications","windows","wireless","wireless-security","x86-64"],"created_at":"2025-04-25T15:09:07.645Z","updated_at":"2026-01-29T22:06:54.262Z","avatar_url":"https://github.com/PentHertz.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 RF Swift 📡\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg alt=\"RF Swift logo\" width=\"600\" src=\"https://github.com/PentHertz/RF-Swift-docs/blob/main/.assets/logo.png?raw=true\"\u003e\n  \u003cbr\u003e\u003cbr\u003e\n  \u003cimg alt=\"linux supported\" src=\"https://img.shields.io/badge/linux-supported-success\"\u003e\n  \u003cimg alt=\"windows supported\" src=\"https://img.shields.io/badge/windows-supported-success\"\u003e\n  \u003cimg alt=\"macOS supported\" src=\"https://img.shields.io/badge/macos-supported-success\"\u003e\n  \n  \u003cbr\u003e\n  \u003cimg alt=\"amd64\" src=\"https://img.shields.io/badge/amd64%20(x86__64)-supported-success\"\u003e\n  \u003cimg alt=\"arm64\" src=\"https://img.shields.io/badge/arm64%20(aarch64)-supported-success\"\u003e\n  \u003cimg alt=\"riscv64\" src=\"https://img.shields.io/badge/riscv64-supported-success\"\u003e\n  \u003cbr\u003e\u003cbr\u003e\n   \u003ca target=\"_blank\" rel=\"noopener noreferrer\" href=\"https://www.blackhat.com/eu-24/arsenal/schedule/index.html#rf-swift-a-swifty-toolbox-for-all-wireless-assessments-41157\" title=\"Schedule\"\u003e\n   \u003cimg alt=\"Black Hat Europe 2024\" src=\"https://img.shields.io/badge/Black%20Hat%20Arsenal-Europe%202024-blueviolet\"\u003e\n  \u003c/a\u003e\n  \u003ca target=\"_blank\" rel=\"noopener noreferrer\" href=\"https://spectrum-conference.org/24/schedule\" title=\"Schedule\"\u003e\n   \u003cimg alt=\"Spectrum 24\" src=\"https://img.shields.io/badge/Spectrum-2024-yellow\"\u003e\n  \u003c/a\u003e\n  \u003ca target=\"_blank\" rel=\"noopener noreferrer\" href=\"https://fosdem.org/2025/schedule/event/fosdem-2025-4301-rf-swift-a-swifty-toolbox-for-all-wireless-assessments/\" title=\"Schedule\"\u003e\n   \u003cimg alt=\"FOSDEM 2025\" src=\"https://img.shields.io/badge/FOSDEM-2025-pink\"\u003e\n  \u003c/a\u003e\n  \u003ca target=\"_blank\" rel=\"noopener noreferrer\" href=\"https://www.cyberonboard.org/en/content/sujetsscientifiques\" title=\"Schedule\"\u003e\n   \u003cimg alt=\"CyberOnBoard\" src=\"https://img.shields.io/badge/CyberOnBoard-2025-green\"\u003e\n  \u003c/a\u003e\n  \u003ca target=\"_blank\" rel=\"noopener noreferrer\" href=\"https://www.prasec.cz/index.html#topics\" title=\"Schedule\"\u003e\n   \u003cimg alt=\"PraSec\" src=\"https://img.shields.io/badge/PraSec-2025-green\"\u003e\n  \u003c/a\u003e\n  \u003cbr\u003e\u003cbr\u003e\n  \u003ca target=\"_blank\" rel=\"noopener noreferrer\" href=\"https://x.com/intent/follow?screen_name=FlUxIuS\" title=\"Follow\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/_nwodtuhs?label=FlUxIuS\u0026style=social\" alt=\"Twitter FlUxIuS\"\u003e\u003c/a\u003e\n  \u003ca target=\"_blank\" rel=\"noopener noreferrer\" href=\"https://x.com/intent/follow?screen_name=Penthertz\" title=\"Follow\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/_nwodtuhs?label=Penthertz\u0026style=social\" alt=\"Twitter Penthertz\"\u003e\u003c/a\u003e\n  \u003cbr\u003e\u003cbr\u003e\n  \u003ca target=\"_blank\" rel=\"noopener noreferrer\" href=\"https://discord.gg/NS3HayKrpA\" title=\"Join us on Discord\"\u003e\u003cimg src=\"https://github.com/PentHertz/RF-Swift-docs/blob/main/.assets/discord_join_us.png?raw=true\" width=\"150\" alt=\"Join us on Discord\"\u003e\u003c/a\u003e\n  \u003cbr\u003e\u003cbr\u003e\n\u003c/div\u003e\n\n\nhttps://github.com/user-attachments/assets/518c5045-4380-48d0-a731-6ec0273a02c5\n\n\n## 🔍 What is RF Swift?\n\nRF Swift is a revolutionary toolbox that transforms any computer into a powerful RF testing laboratory without requiring a dedicated operating system. 🔄 Unlike traditional approaches that force you to sacrifice your primary OS, RF Swift brings containerized RF tools to your existing environment. 🏠\n\n### ⚡ Why RF Swift Outperforms Dedicated OS Solutions\n\n| Feature | RF Swift | Dedicated OS |\n|---------|---------|------------------------------|\n| **🏠 Host OS Preservation** | ✅ Keep your existing OS | ❌ Requires dedicated partition or VM |\n| **🛡️ Tool Isolation** | ✅ Tools contained without system impact | ❌ Tools can destabilize system |\n| **⚡ Deployment Speed** | ✅ Seconds to deploy | ❌ Hours for full installation |\n| **💾 Disk Space** | ✅ Only install tools you need | ❌ Requires 20-50GB minimum |\n| **🔄 Updates** | ✅ Update individual tools without risk | ❌ System-wide updates can break functionality |\n| **🌐 Multi-architecture** | ✅ x86_64, ARM64, RISCV64 and more! | ❌ Limited architecture support |\n| **🔁 Reproducibility** | ✅ Identical environments everywhere | ❌ System drift between other installations |\n| **💼 Work Environment** | ✅ Use alongside productivity tools | ❌ Switch contexts between systems |\n| **📹 Session Recording** | ✅ Built-in recording for documentation | ❌ Manual setup required |\n| **🎨 Easy Customization** | ✅ Simple YAML recipes for custom images | ❌ Complex OS modifications |\n\n## ✨ Key Features\n\n### Core Capabilities\n- **🏠 Non-disruptive Integration**: Run specialized RF tools while continuing to use your preferred OS for daily work\n- **🧩 Modular Tool Selection**: Deploy only the tools you need, when you need them\n- **🛡️ Containerized Isolation**: Prevent RF tools from affecting system stability or security\n- **🌍 Cross-platform Compatibility**: Works seamlessly on Linux, Windows, and macOS\n- **🔌 Dynamic Hardware Integration**: Connect and disconnect USB devices without restarting\n- **⚡ GPU Acceleration**: Dedicated images with OpenCL support for Intel and NVIDIA GPUs\n- **💾 Space Efficiency**: Use a fraction of the disk space required by dedicated OS solutions\n\n## 🎬 Demo Videos\n\n### 🐧 On Linux\nhttps://github.com/PentHertz/RF-Swift/assets/715195/bb2ccd96-b688-4106-8fba-d82f84ff1ea4\n\n### 🪟 On Windows (With GQRX)\nhttps://github.com/PentHertz/RF-Swift/assets/715195/25a4a857-aa5a-4daa-9a08-28fa53d2f799\n\n### 🖥️ Using OpenCL with Intel or NVIDIA GPU\n![OpenCL recipe in action](https://github.com/PentHertz/RF-Swift/assets/715195/a29eedd5-b1df-40fc-97c0-4dc5323f36a8)\n\n## 📦 Available Specialized Images\n\nRF Swift's container approach allows for specialized environments optimized for specific tasks:\n\n| Category | Images | Description |\n|----------|--------|-------------|\n| 📻 SDR | `sdr_light`, `sdr_full` | Software-defined radio tools (RTL-SDR, HackRF, etc.) |\n| 📱 Telecom | `telecom_utils`, `telecom_2Gto3G`, `telecom_4G_5GNSA`, `telecom_5G` | Mobile network analysis and testing |\n| 📶 Short-range | `bluetooth`, `wifi`, `rfid` | Bluetooth, Wi-Fi, and RFID security tools |\n| 🔧 Hardware | `hardware`, `reversing` | Hardware hacking and reverse engineering |\n| 🚗 Automotive | `automotive` | Vehicle communication protocols (CAN, LIN, etc.) |\n\nFull image list with detailed tool inventory available at [rfswift.io/docs/guide/list-of-images/](https://rfswift.io/docs/guide/list-of-images/)\n\n## 🌟 Real-World Use Cases\n\n### 👔 For Professionals\n\n- **🧰 Rapid Assessment Deployment**: Deploy a complete RF lab at client sites in minutes\n- **🔄 Consistent Environments**: Eliminate \"works on my machine\" issues\n- **⚙️ Parallel Testing**: Run multiple isolated assessments simultaneously\n- **📹 Documentation**: Built-in session recording for client reports\n- **🛠️ Custom Toolsets**: Create specialized containers for specific engagements\n\n### 🔬 For Researchers\n\n- **📊 Reproducible Research**: Share exact tool environments with papers\n- **🧪 Experiment Isolation**: Keep experimental configurations separate\n- **🌐 Multi-platform Collaboration**: Work across Linux, Windows, and macOS\n- **🔢 Version Control**: Test with specific tool versions for reproducibility\n- **⚡ Resource Optimization**: Allocate resources based on research needs\n\n### 👨‍🏫 For Educators\n\n- **🏫 Classroom Deployment**: Identical environments for all students\n- **💻 No OS Reinstall**: Students keep their existing operating systems\n- **🖥️ Low Requirements**: Works on standard lab computers\n- **📚 Focused Learning**: Custom containers for specific lessons\n- **🔄 Quick Reset**: Easily reset environments between classes\n\n### 🏭 For Manufacturing \u0026 QA\n\n- **🔍 Production Testing**: Consistent RF testing environments\n- **📡 Device Validation**: Test wireless product compliance\n- **🔧 Firmware Analysis**: Isolated environments for firmware testing\n- **📊 Quality Assurance**: Reproducible test configurations\n\n## 📖 Documentation\n\nComprehensive documentation is available at [rfswift.io](https://rfswift.io/), including:\n\n- 🚀 [Getting Started Guide](https://rfswift.io/docs/getting-started/)\n- 🏁 [Quick Start Tutorial](https://rfswift.io/docs/quick-start/)\n- 📘 [User Guide](https://rfswift.io/docs/guide/)\n- 📝 [YAML Recipe Guide](https://rfswift.io/docs/development/yaml-recipe-guide/)\n- 👨‍💻 [Development Documentation](https://rfswift.io/docs/development/)\n- 🧰 [List of Included Tools](https://rfswift.io/docs/guide/list-of-tools/)\n- 🛡️ [Security Guidelines](https://rfswift.io/docs/security/)\n\n## 🎓 Training \u0026 Workshops\n\nRF Swift is used in professional training courses by Penthertz:\n- 📻 Software Defined Radio assessments\n- 📱 Mobile network security testing\n- 🚗 Automotive security analysis\n- 🏭 IoT and embedded device testing\n\n[Contact us](https://penthertz.com/) for custom training programs.\n\n## 👥 Community \u0026 Support\n\n- 💬 [Join our Discord](https://discord.gg/NS3HayKrpA) for community support and discussions\n- 🐛 [Report issues](https://github.com/PentHertz/RF-Swift/issues) on GitHub\n- 💡 [Request features](https://github.com/PentHertz/RF-Swift/discussions) via GitHub Discussions\n- 🐦 Follow us on X (Twitter): [@FlUxIuS](https://x.com/FlUxIuS) and [@Penthertz](https://x.com/Penthertz)\n- 📧 Professional inquiries: [penthertz.com](https://penthertz.com/)\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how you can help:\n\n### Code Contributions\n- 🧰 **Tool Integration**: Add new tools or improve existing ones\n- 🐞 **Bug Fixes**: Submit PRs to fix reported issues\n- ✨ **New Features**: Implement new capabilities\n- 📝 **Documentation**: Improve guides and examples\n\n### Community Contributions\n- 📝 **YAML Recipes**: Share your custom image recipes\n- 🎓 **Tutorials**: Create guides for specific tools or workflows\n- 🐛 **Bug Reports**: Report issues you encounter\n- 💡 **Feature Requests**: Suggest improvements\n\n### Getting Started with Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## ⚖️ License\n\nRF Swift is released under the GNU General Public License v3.0. See [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\nSpecial thanks to:\n- All contributors and clients who have helped improve RF Swift\n- The open-source RF and security tool developers whose work we integrate\n- The community for feedback, bug reports, and feature requests\n- Conference organizers who have hosted our presentations\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpenthertz%2Frf-swift","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpenthertz%2Frf-swift","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpenthertz%2Frf-swift/lists"}