A beautiful, secure desktop application for encrypting and decrypting files and directories with an intuitive file explorer interface.
- 🔒 Secure AES Encryption - Military-grade encryption for your sensitive files
- 📁 Directory Encryption - Encrypt entire directories with a single password
- 🎯 Individual File Encryption - Encrypt specific files independently
- 🎨 Beautiful Dark UI - Modern, responsive interface with smooth animations
- 📊 File Statistics - Track encrypted vs unencrypted files
- 🔍 Built-in File Explorer - Browse and manage files without leaving the app
- 💪 Password Strength Indicator - Real-time password security feedback
- 🔔 Smart Notifications - Get informed about all operations
- 🚀 Cross-Platform - Works on Windows, macOS, and Linux
- ⚡ Fast Performance - Optimized for large directories and files
The app features a clean, dark interface with a sidebar for actions and statistics, and a main file explorer area.
Built-in password strength meter helps you create secure passwords for your encrypted files.
- Node.js (version 16 or higher)
- npm or yarn package manager
-
Clone or download the project
cd maraikka-app -
Install dependencies
npm install
-
Run the application
npm start
To create distributable packages for your platform:
# Build for current platform
npm run build
# Build for Windows
npm run build-win
# Build for macOS
npm run build-mac
# Build for Linux
npm run build-linuxBuilt applications will be available in the dist directory.
-
Launch the Application
- Double-click the Maraikka icon
- The application will open with an empty file explorer
-
Select a Directory
- Click "Select Directory" in the header or sidebar
- Choose the folder containing files you want to encrypt/decrypt
- The file explorer will display all contents
- Select a directory containing your files
- Click the "Encrypt Directory" button in the sidebar
- Enter a strong password in the modal dialog
- Confirm the operation
- All files in the directory will be encrypted with
.encextension
- Select a directory containing encrypted files (
.encfiles) - Click the "Decrypt Directory" button in the sidebar
- Enter the same password used for encryption
- Confirm the operation
- All encrypted files will be restored to their original format
- Hover over any unencrypted file in the file list
- Click the "Encrypt" button that appears
- Enter a password for this specific file
- The file will be encrypted and marked with a lock icon
- Hover over any encrypted file (shown with lock icon)
- Click the "Decrypt" button that appears
- Enter the password used to encrypt the file
- The file will be decrypted and restored
- The app includes a real-time password strength meter
- Passwords are evaluated for:
- Length (minimum 6 characters recommended)
- Uppercase letters
- Lowercase letters
- Numbers
- Special characters
- Uses AES (Advanced Encryption Standard) encryption
- Files are converted to Base64 before encryption for binary safety
- Original files are securely deleted after encryption
- Encrypted files use
.encextension for easy identification
- List View: Detailed file information with sizes and dates
- File Statistics: Real-time count of files, directories, and encrypted items
- Visual Indicators: Different colors and icons for directories, files, and encrypted items
- Hover Actions: Encrypt/decrypt buttons appear on file hover
- Progress Tracking: Visual progress bars for operations
- Smart Notifications: Success/error notifications for all operations
- All file types are supported for encryption
- Binary files (images, videos, executables) are handled safely
- Text files maintain integrity after decryption
- Directory structures are preserved
- Use Strong Passwords: Combine uppercase, lowercase, numbers, and symbols
- Remember Your Passwords: Lost passwords cannot be recovered
- Backup Important Files: Keep unencrypted copies in secure locations
- Test Decryption: Verify files decrypt correctly before deleting originals
- Passwords are never stored or logged
- Each encryption operation uses the provided password as the key
- Files are processed locally - no data leaves your computer
- Original files are securely deleted after successful encryption
App won't start
- Ensure Node.js is installed (version 16+)
- Run
npm installto install dependencies - Check for any error messages in the terminal
Encryption/Decryption fails
- Verify the password is correct
- Ensure you have write permissions to the directory
- Check available disk space
- Close any programs that might be using the files
Files appear corrupted after decryption
- This usually indicates an incorrect password was used
- Try the decryption again with the correct password
- Check if the
.encfile is corrupted
- For large directories, encryption/decryption may take time
- Close other applications to free up system resources
- Avoid interrupting the process once started
maraikka-app/
├── src/
│ ├── main.js # Main Electron process
│ ├── preload.js # Secure IPC bridge
│ └── renderer/
│ ├── index.html # Main UI
│ ├── styles.css # Application styles
│ └── renderer.js # UI logic and interactions
├── package.json # Dependencies and scripts
└── README.md # Documentation
- Electron: Cross-platform desktop framework
- Node.js: Backend runtime
- Crypto-JS: Encryption library
- fs-extra: Enhanced file system operations
- HTML/CSS/JavaScript: Frontend technologies
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request
MIT License - feel free to use this project for personal or commercial purposes.
For issues, questions, or suggestions:
- Check the troubleshooting section above
- Review existing issues in the project repository
- Create a new issue with detailed information about your problem
Made with ❤️ for secure file management