paqetN is a feature-rich desktop application for managing paqet proxy configurations. Built with Qt 6 and QML, it provides an intuitive Microsoft Fluent Design interface for configuring, connecting, and monitoring your packet-level proxy connections.
The application runs paqet in SOCKS-only mode, allowing you to easily route your browser or system traffic through 127.0.0.1:<port>.
- Configuration Management: Add, edit, delete, and organize proxy configurations
- Quick Connect: One-click connection to any saved profile
- Real-time Monitoring: Live log viewer showing paqet stdout/stderr
- Latency Testing: Test proxy connection speed before connecting
- Import/Export: Support for
paqet://URLs, JSON, and YAML formats
- Auto-Update System: Automatic updates for both paqetN and paqet binary
- Group Organization: Organize configs into collapsible groups
- Clipboard Integration: Quick import from clipboard
- File Import/Export: Import configs from files or export for backup
- Theme Support: Dark, Light, and System theme modes
- Single Instance Guard: Prevents multiple instances running simultaneously
- High-DPI Support: Crisp UI on high-resolution displays
- Microsoft Fluent Design: Modern, polished UI using FluentUI framework
- Card-Based Layout: Intuitive grid view for configuration browsing
- Detail Panel: Quick access to config details and actions
- Settings Page: Centralized configuration for app preferences
- Log Management: Word wrap, export, copy, and clear log functionality
Download the latest release for your platform from the Releases page.
- Download
paqetN-windows-x64.zip - Extract and run
apppaqetN.exe - Ensure
paqet.exeis in the same directory or in your PATH
# Download and extract
wget https://github.com/AliRezaBeigy/paqetN/releases/latest/download/paqetN-linux-x64.tar.gz
tar -xzf paqetN-linux-x64.tar.gz
# Run
./apppaqetN# Download and mount DMG
# Drag paqetN.app to Applications folderpaqetN requires the paqet proxy binary to function. The application can automatically download it for you:
- Auto-Download (Recommended): Navigate to Updates page and click "Download & Install" for paqet
- Manual Download: Get pre-built binaries from paqet releases
- Build from source: See docs/BUILDING.md
- Configure path: Set custom paqet binary path in Settings
# Clone repository with submodules
git clone --recursive https://github.com/AliRezaBeigy/paqetN.git
cd paqetN
# Configure (adjust Qt path as needed)
export CMAKE_PREFIX_PATH=/path/to/Qt/6.8/gcc_64
cmake -B build
# Build
cmake --build build
# Run
./build/apppaqetNSee docs/BUILDING.md for comprehensive build instructions including:
- Platform-specific requirements
- Qt installation and configuration
- Compiler setup (especially Windows/MinGW)
- Building paqet from source
- Running tests
- Deployment and packaging
- Launch paqetN: Run the application executable
- Add a Configuration:
- Click Add button or Import from Clipboard
- Paste a
paqet://...URL or enter details manually - Click Add to save
- Connect to Proxy:
- Select a configuration from the grid
- Click Connect in the detail panel
- Configure your browser/system to use SOCKS5 proxy:
127.0.0.1:<port>
- Monitor Connection:
- View real-time logs in the Logs page
- Test latency using the Test button
- Disconnect: Click Disconnect to stop the proxy
Access settings via the Settings navigation item:
- Theme: Dark, Light, or System (follows OS theme)
- SOCKS Port: Default local port for proxy (default: 1284)
- Connection Check URL: URL for latency testing
- Log Level: Debug, Info, Warn, or Error
- paqet Binary Path: Custom path to paqet executable (optional)
- Configurations: Stored in
configs.jsonat:- Windows:
%APPDATA%/paqetN/configs.json - Linux:
~/.local/share/paqetN/configs.json - macOS:
~/Library/Application Support/paqetN/configs.json
- Windows:
- Settings: Platform-specific (QSettings):
- Windows: Registry or INI file
- Linux:
~/.config/paqetN/paqetN.conf - macOS:
~/Library/Preferences/paqetN.plist
- Building from Source: Detailed build instructions
- Architecture: Technical architecture and design
- Development Guide: Development workflow and tips
- Contributing Guidelines: How to contribute to the project
- Qt 6.8+ (Quick, Network, Widgets, Svg, PrintSupport modules)
- CMake 3.20+
- C++17 compiler (GCC 9+, Clang 10+, MSVC 2019+, or MinGW 13.1+)
paqetN/
├── .github/ # GitHub workflows and templates
├── 3rdparty/ # FluentUI dependency
├── docs/ # Documentation
├── qml/ # QML UI files
│ ├── components/ # Reusable UI components
│ ├── dialogs/ # Dialog windows
│ ├── pages/ # Main pages
│ └── Main.qml # Root window
├── scripts/ # Build scripts
├── src/ # C++ source files
├── tests/ # Unit and UI tests
└── CMakeLists.txt # CMake configuration
cd build
ctest -V
# Or run directly with verbose output
./tst_paqetn -v2Tests cover:
- Configuration parsing and serialization
- Repository CRUD operations
- Log buffer management
- Qt model interface
- Controller orchestration
- UI smoke tests
We welcome contributions! Please see CONTRIBUTING.md for:
- Code of conduct
- Development setup
- Coding standards
- Testing guidelines
- Pull request process
- Qt 6: Cross-platform application framework
- QML: Declarative UI
- FluentUI: Microsoft Fluent Design System for Qt
- QuaZip: Qt/C++ wrapper for ZIP/UNZIP
- CMake: Build system
- C++17: Backend implementation
- Qt Test: Testing framework
This project is licensed under the MIT License - see the LICENSE file for details.
- paqet - The packet-level proxy this client manages
- FluentUI - Fluent Design System for Qt
- QuaZip - Qt wrapper for ZIP archives
- Qt Project - Cross-platform application framework
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Documentation: docs/ directory
Made with ❤️ using Qt and FluentUI