https://github.com/penthertz/rf-swift

🚀 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. 📡✨
https://github.com/penthertz/rf-swift

arm64 docker hardware linux pentesting rf risc-v sdr security security-audit security-tools telecommunications windows wireless wireless-security x86-64

Last synced: 13 days ago
JSON representation

🚀 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. 📡✨

• Host: GitHub
• URL: https://github.com/penthertz/rf-swift
• Owner: PentHertz
• License: gpl-3.0
• Created: 2024-05-18T13:38:03.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-04-21T20:17:22.000Z (10 months ago)
• Last Synced: 2025-04-25T15:08:56.446Z (10 months ago)
• Topics: arm64, docker, hardware, linux, pentesting, rf, risc-v, sdr, security, security-audit, security-tools, telecommunications, windows, wireless, wireless-security, x86-64
• Language: Go
• Homepage: https://rfswift.io/
• Size: 35.3 MB
• Stars: 180
• Watchers: 5
• Forks: 9
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 🚀 RF Swift 📡



  

  



  

  

  

  

  


  

  

  

  



   

   

  

  

   

  

  

   

  

  

   

  

  

   

  

  



  

  

  



  

  





https://github.com/user-attachments/assets/518c5045-4380-48d0-a731-6ec0273a02c5

## 🔍 What is RF Swift?

RF 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. 🏠

### ⚡ Why RF Swift Outperforms Dedicated OS Solutions

| Feature | RF Swift | Dedicated OS |

|---------|---------|------------------------------|

| **🏠 Host OS Preservation** | ✅ Keep your existing OS | ❌ Requires dedicated partition or VM |

| **🛡️ Tool Isolation** | ✅ Tools contained without system impact | ❌ Tools can destabilize system |

| **⚡ Deployment Speed** | ✅ Seconds to deploy | ❌ Hours for full installation |

| **💾 Disk Space** | ✅ Only install tools you need | ❌ Requires 20-50GB minimum |

| **🔄 Updates** | ✅ Update individual tools without risk | ❌ System-wide updates can break functionality |

| **🌐 Multi-architecture** | ✅ x86_64, ARM64, RISCV64 and more! | ❌ Limited architecture support |

| **🔁 Reproducibility** | ✅ Identical environments everywhere | ❌ System drift between other installations |

| **💼 Work Environment** | ✅ Use alongside productivity tools | ❌ Switch contexts between systems |

| **📹 Session Recording** | ✅ Built-in recording for documentation | ❌ Manual setup required |

| **🎨 Easy Customization** | ✅ Simple YAML recipes for custom images | ❌ Complex OS modifications |

## ✨ Key Features

### Core Capabilities

- **🏠 Non-disruptive Integration**: Run specialized RF tools while continuing to use your preferred OS for daily work

- **🧩 Modular Tool Selection**: Deploy only the tools you need, when you need them

- **🛡️ Containerized Isolation**: Prevent RF tools from affecting system stability or security

- **🌍 Cross-platform Compatibility**: Works seamlessly on Linux, Windows, and macOS

- **🔌 Dynamic Hardware Integration**: Connect and disconnect USB devices without restarting

- **⚡ GPU Acceleration**: Dedicated images with OpenCL support for Intel and NVIDIA GPUs

- **💾 Space Efficiency**: Use a fraction of the disk space required by dedicated OS solutions

## 🎬 Demo Videos

### 🐧 On Linux

https://github.com/PentHertz/RF-Swift/assets/715195/bb2ccd96-b688-4106-8fba-d82f84ff1ea4

### 🪟 On Windows (With GQRX)

https://github.com/PentHertz/RF-Swift/assets/715195/25a4a857-aa5a-4daa-9a08-28fa53d2f799

### 🖥️ Using OpenCL with Intel or NVIDIA GPU

![OpenCL recipe in action](https://github.com/PentHertz/RF-Swift/assets/715195/a29eedd5-b1df-40fc-97c0-4dc5323f36a8)

## 📦 Available Specialized Images

RF Swift's container approach allows for specialized environments optimized for specific tasks:

| Category | Images | Description |

|----------|--------|-------------|

| 📻 SDR | `sdr_light`, `sdr_full` | Software-defined radio tools (RTL-SDR, HackRF, etc.) |

| 📱 Telecom | `telecom_utils`, `telecom_2Gto3G`, `telecom_4G_5GNSA`, `telecom_5G` | Mobile network analysis and testing |

| 📶 Short-range | `bluetooth`, `wifi`, `rfid` | Bluetooth, Wi-Fi, and RFID security tools |

| 🔧 Hardware | `hardware`, `reversing` | Hardware hacking and reverse engineering |

| 🚗 Automotive | `automotive` | Vehicle communication protocols (CAN, LIN, etc.) |

Full image list with detailed tool inventory available at [rfswift.io/docs/guide/list-of-images/](https://rfswift.io/docs/guide/list-of-images/)

## 🌟 Real-World Use Cases

### 👔 For Professionals

- **🧰 Rapid Assessment Deployment**: Deploy a complete RF lab at client sites in minutes

- **🔄 Consistent Environments**: Eliminate "works on my machine" issues

- **⚙️ Parallel Testing**: Run multiple isolated assessments simultaneously

- **📹 Documentation**: Built-in session recording for client reports

- **🛠️ Custom Toolsets**: Create specialized containers for specific engagements

### 🔬 For Researchers

- **📊 Reproducible Research**: Share exact tool environments with papers

- **🧪 Experiment Isolation**: Keep experimental configurations separate

- **🌐 Multi-platform Collaboration**: Work across Linux, Windows, and macOS

- **🔢 Version Control**: Test with specific tool versions for reproducibility

- **⚡ Resource Optimization**: Allocate resources based on research needs

### 👨‍🏫 For Educators

- **🏫 Classroom Deployment**: Identical environments for all students

- **💻 No OS Reinstall**: Students keep their existing operating systems

- **🖥️ Low Requirements**: Works on standard lab computers

- **📚 Focused Learning**: Custom containers for specific lessons

- **🔄 Quick Reset**: Easily reset environments between classes

### 🏭 For Manufacturing & QA

- **🔍 Production Testing**: Consistent RF testing environments

- **📡 Device Validation**: Test wireless product compliance

- **🔧 Firmware Analysis**: Isolated environments for firmware testing

- **📊 Quality Assurance**: Reproducible test configurations

## 📖 Documentation

Comprehensive documentation is available at [rfswift.io](https://rfswift.io/), including:

- 🚀 [Getting Started Guide](https://rfswift.io/docs/getting-started/)

- 🏁 [Quick Start Tutorial](https://rfswift.io/docs/quick-start/)

- 📘 [User Guide](https://rfswift.io/docs/guide/)

- 📝 [YAML Recipe Guide](https://rfswift.io/docs/development/yaml-recipe-guide/)

- 👨‍💻 [Development Documentation](https://rfswift.io/docs/development/)

- 🧰 [List of Included Tools](https://rfswift.io/docs/guide/list-of-tools/)

- 🛡️ [Security Guidelines](https://rfswift.io/docs/security/)

## 🎓 Training & Workshops

RF Swift is used in professional training courses by Penthertz:

- 📻 Software Defined Radio assessments

- 📱 Mobile network security testing

- 🚗 Automotive security analysis

- 🏭 IoT and embedded device testing

[Contact us](https://penthertz.com/) for custom training programs.

## 👥 Community & Support

- 💬 [Join our Discord](https://discord.gg/NS3HayKrpA) for community support and discussions

- 🐛 [Report issues](https://github.com/PentHertz/RF-Swift/issues) on GitHub

- 💡 [Request features](https://github.com/PentHertz/RF-Swift/discussions) via GitHub Discussions

- 🐦 Follow us on X (Twitter): [@FlUxIuS](https://x.com/FlUxIuS) and [@Penthertz](https://x.com/Penthertz)

- 📧 Professional inquiries: [penthertz.com](https://penthertz.com/)

## 🤝 Contributing

We welcome contributions! Here's how you can help:

### Code Contributions

- 🧰 **Tool Integration**: Add new tools or improve existing ones

- 🐞 **Bug Fixes**: Submit PRs to fix reported issues

- ✨ **New Features**: Implement new capabilities

- 📝 **Documentation**: Improve guides and examples

### Community Contributions

- 📝 **YAML Recipes**: Share your custom image recipes

- 🎓 **Tutorials**: Create guides for specific tools or workflows

- 🐛 **Bug Reports**: Report issues you encounter

- 💡 **Feature Requests**: Suggest improvements

### Getting Started with Contributing

1. Fork the repository

2. Create a feature branch (`git checkout -b feature/amazing-feature`)

3. Commit your changes (`git commit -m 'Add amazing feature'`)

4. Push to the branch (`git push origin feature/amazing-feature`)

5. Open a Pull Request

## ⚖️ License

RF Swift is released under the GNU General Public License v3.0. See [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

Special thanks to:

- All contributors and clients who have helped improve RF Swift

- The open-source RF and security tool developers whose work we integrate

- The community for feedback, bug reports, and feature requests

- Conference organizers who have hosted our presentations