PySnoop

A modern Python-based application for reading, writing, and analyzing magnetic stripe card data. This project is a continuation of the original StripeSnoop project, rebuilt with modern Python and a user-friendly interface.

✨ Features

• Card Reading: Read magnetic stripe cards using compatible readers
• Database Management: Store and manage card data securely
• Multiple Formats: Export/Import card data in various formats
• Modern GUI: User-friendly interface with theming support
• Cross-Platform: Works on Windows, macOS, and Linux
• Standalone Executable: Build as a single executable file for easy distribution
• Debug Builds: Special debug configuration for troubleshooting
• Security: Secure storage for sensitive card data
• Validation: Built-in card number validation (C10/Luhn)
• Documentation: Comprehensive documentation and examples

🚀 Installation

Prerequisites

• Python 3.7 or higher
• pip (Python package manager)
• Git (optional, for development)

Quick Start

1. Clone the repository:

   git clone https://github.com/Nsfr750/PySnoop.git
   cd PySnoop
   

2. Create and activate a virtual environment:

   # Windows
   python -m venv venv
   .\venv\Scripts\activate
      
   # macOS/Linux
   python3 -m venv venv
   source venv/bin/activate
   

3. Install dependencies:

   pip install -r requirements.txt
   

🏗️ Building the Application

PySnoop can be built into a standalone executable using Nuitka. We provide two build scripts:

Debug Build

.\snoop_debug.bat

This creates a debug version of the application with the console window enabled for troubleshooting.

Release Build

.\snoop.bat

This creates an optimized release version of the application.

Build Outputs

• Debug build: build\PySnoop_debug.exe
• Release build: build\PySnoop.exe

🛠️ Development

   pip install -r requirements.txt

💻 Usage

GUI Mode (Recommended)

python pysnoop_gui.py

Command Line Interface

python pysnoop.py [options]

Available Options

-h, --help      Show help message and exit
-v, --verbose   Enable verbose output
--version       Show version information

🔌 Supported Devices

• MSR605 Magnetic Stripe Card Reader/Writer
• Other HID-compatible card readers (experimental)

📚 Documentation

For detailed documentation, including API reference and usage examples, please visit the documentation.

🤝 Contributing

Contributions are welcome! Please read our contributing guidelines to get started.

📄 License

This project is licensed under the GPLv3 License - see the LICENSE file for details.

🙏 Support

If you find this project useful, consider supporting its development:

📧 Contact

For questions or support, please open an issue or contact Nsfr750.

Credits

• Based on the original StripeSnoop project (http://stripesnoop.sourceforge.net)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.