ProtonDrive Linux Client

🎮 RGX Mods - RealmGX Community Project

🌟 Join the RealmGX Community - Gamers eXtreme! 🌟

An unofficial Linux desktop client for ProtonDrive, featuring a premium GUI that matches Proton's signature design.

🎯 Connect with fellow Linux enthusiasts, get support, and be part of the RGX Mods family!

🌟 Join the RGX Mods Community!

💬 RealmGX Discord - Your Tech Home!

🎮 Realm Gamers eXtreme - Where Linux Enthusiasts Unite!

✨ What awaits you in our Discord:

• 🛠️ Instant support from the RGX Mods team
• 🎯 Feature requests and direct dev communication
• 🚀 Beta testing opportunities for new releases
• 🤝 Community of Linux users sharing tips and experiences
• 📢 First to know about new RGX Mods releases
• 🎉 Events, giveaways, and community activities

💖 Support RGX Mods

Your support helps keep RGX Mods alive and constantly improving!

Every coffee helps fund new features and improvements!

🚀 Features

Feature	Description
🎨 Premium Proton Design	Beautiful dark theme matching Proton's signature style
🔐 Secure Authentication	ProtonMail credentials with full 2FA support
📁 Sync Folders	Bi-directional sync between local and ProtonDrive
🔍 Browse Files	Navigate your ProtonDrive storage
💾 Mount as Drive	Access ProtonDrive as local filesystem
🖥️ Modern GUI	Sleek interface with status indicators and activity log
🐧 Desktop Integration	System tray, notifications, and .desktop file

📦 Installation

Official Packages

Arch Linux (AUR)

yay -S protondrive-linux
# or
paru -S protondrive-linux

Flatpak (All Distros)

flatpak install flathub io.github.donniedice.protondrive
flatpak run io.github.donniedice.protondrive

AppImage (All Distros)

wget https://github.com/donniedice/protondrive-linux/releases/latest/download/ProtonDrive-x86_64.AppImage
chmod +x ProtonDrive-x86_64.AppImage
./ProtonDrive-x86_64.AppImage

Ubuntu/Debian (PPA)

sudo add-apt-repository ppa:donniedice/protondrive
sudo apt update
sudo apt install protondrive-linux

Fedora (COPR)

sudo dnf copr enable donniedice/protondrive
sudo dnf install protondrive-linux

From Source

# Clone repository
git clone https://github.com/donniedice/protondrive-linux.git
cd protondrive-linux

# Install dependencies
pip install -r requirements.txt

# Install
pip install -e .

# Run
protondrive-gui

🔧 Requirements

• OS: Linux (any distribution)
• Python: 3.8+
• Dependencies:
  • rclone (auto-installed)
  • python3-tk
  • python3-pip

📖 Usage

1. Launch: Run protondrive-gui from terminal or application menu
2. Configure: Enter your ProtonMail credentials
   • Email: Your ProtonMail email address
   • Password: Your ProtonMail password
   • 2FA Code: If you have 2FA enabled, enter the current code
3. Connect: Click "Configure ProtonDrive"
4. Use:
   • Sync: Select local folder to sync
   • Browse: View ProtonDrive contents
   • Mount: Mount as local drive

🔐 Two-Factor Authentication (2FA)

If you have 2FA enabled on your ProtonMail account:

1. Enter your 6-digit 2FA code in the "2FA Code" field
2. The code must be current (codes expire every 30 seconds)
3. If configuration fails, try again with a fresh code

Manual Configuration (if GUI fails):

cd /path/to/protondrive-linux
python manual_configure.py

🛠️ Development

Building from Source

# Clone with submodules
git clone --recursive https://github.com/donniedice/protondrive-linux.git
cd protondrive-linux

# Create virtual environment
python -m venv venv
source venv/bin/activate

# Install development dependencies
pip install -r requirements-dev.txt

# Run tests
pytest

# Build package
python setup.py sdist bdist_wheel

CI/CD Pipeline

This project uses GitHub Actions for:

• ✅ Automated testing on multiple Python versions
• ✅ Code quality checks (flake8, black)
• ✅ Security scanning
• ✅ Package building for multiple formats
• ✅ Automatic releases to GitHub, AUR, Flatpak

🤝 Contributing

Contributions are welcome! Please read our Contributing Guidelines.

1. Fork the repository
2. Create feature branch (git checkout -b feature/AmazingFeature)
3. Commit changes (git commit -m 'Add AmazingFeature')
4. Push to branch (git push origin feature/AmazingFeature)
5. Open Pull Request

🔒 Security

• Uses rclone's encrypted configuration
• No credentials stored in plaintext
• All communication via HTTPS
• Regular security audits via GitHub Actions

🔧 Troubleshooting

"Username and password are required" error

• Make sure you've entered both email and password
• If using 2FA, ensure the code is current (not expired)
• Try the manual configuration script: python manual_configure.py

"Command not found: protondrive-gui"

• If installed via pip in a virtual environment, activate it first:

  source venv/bin/activate
  protondrive-gui

• Or run directly: python -m protondrive

2FA Authentication Issues

• 2FA codes expire every 30 seconds - use a fresh code
• Ensure your system time is synchronized
• Some authenticator apps show a countdown timer

Connection Errors

• Check your internet connection
• Verify ProtonMail credentials are correct
• Ensure ProtonDrive is accessible in your region

📊 Project Status

• ✅ Core Features: Complete
• ✅ AUR Package: Available
• 🚧 Flatpak: In Progress
• 🚧 Snap Package: Planned
• 🚧 Official Support: Awaiting Proton response

📈 Project Metrics

Metric	Value
Total Lines of Code
Repository Size
Last Commit
Open Issues
Pull Requests
Contributors
Languages
Watchers

---

🤝 Contributors

Thanks to all the amazing people who have contributed to ProtonDrive Linux Client! 🎉

---

🏆 GitHub Achievements

---

🔥 Streak Stats

---

📝 License

This project is licensed under the GNU General Public License v3.0 - see LICENSE file.

🙏 Acknowledgments

• Proton for ProtonDrive service
• rclone for backend implementation
• Community contributors

⚠️ Disclaimer

This is an unofficial client not affiliated with Proton AG. For official support, use:

• ProtonDrive Web
• Official Mobile Apps

---

🌟 Thank you for choosing RGX Mods! 🌟

Made with ❤️ by the RealmGX Community Lead Developer: DonnieDice

"Making Linux better, one project at a time!"

🎮 RGX Mods - Powered by RealmGX Community