PsychoLogger is your personal logbook for psychonaut experiences. An Android app designed for those who want to document and understand their experiences with psychoactive substances in a responsible and safe way.
- All your data stays on your device — nothing is uploaded to the internet
- Protected with fingerprint or PIN
- Military-grade encryption for your most sensitive entries
- Record substance, dose, date, and time
- Document your set (mindset) and setting (environment)
- Add personal notes and/or use it as a complementary “psychonaut diary”
- Categorize your substances with colors and emojis
- Explore your history through an interactive calendar
- Statistics to better understand your habits
Links to well-known harm-reduction and information websites:
- Erowid – Extensive database on psychoactive substances
- TripSit – Interaction info, dosage guidelines, and real-time assistance
- MAPS – Research on medical, legal, and cultural uses of psychedelics
- PsychonautWiki – Scientific encyclopedia of psychoactive substances
The app blends native Android elements with a smooth web-based interface. Your security is guaranteed from the moment you open the app.
Includes predefined substances (LSD, Ketamine, Opium), and you can add your own:
- Psychedelics 🍄
- Stimulants/MDMA ⚡
- Dissociatives 🌀
- Depressants 😴
- Export everything to CSV anytime
- Import data from other formats
- Migrate easily between devices
- Backup your information locally and securely
- Biometric unlock: fingerprint, face, etc.
- Backup PIN
- Auto-lock: closes itself after inactivity
- Secure entry point: verification required every time
- Android 7.0 or higher
- About 20MB of storage
- Biometric sensor (recommended but not required)
- Download the APK or clone this repo
- If building from source: Android Studio + Gradle
- Install on your device
- Set your PIN and biometrics on first launch
- Set up your security – Choose a PIN and enable biometrics
- Add your substances – Customize them with colors and emojis
- Adjust preferences – Auto-lock time, etc.
- Open the app – Authenticate with fingerprint or PIN
- Log your experience – Substance, dose, context, notes
- Review your data – Calendar, graphs, statistics
- Export when you need a backup
Built using modern Android technologies:
- Kotlin as the main language
- Jetpack Compose for smooth native UI
- Material 3 for a clean and familiar design
- AndroidX Encryption for maximum security
- Hybrid WebView for the main interface
PsychoLogger is designed for:
- ✅ Education about psychoactive substances
- ✅ Harm reduction through documentation
- ✅ Self-knowledge and understanding patterns
- ✅ Responsible research
It is NOT:
- ❌ A promotion of recreational use
- ❌ A replacement for professional medical advice
- ❌ Intended for minors
- Package: com.d4vram.psychologger
- Target: Android 14 (API 36)
- Minimum: Android 7.0 (API 24)
- Size: = 3MB installed
Your entries are stored in a structured way:
📁 Substances (name, color, emoji, date)
📁 Entries (substance, dose, date, set, setting, notes)
📁 Preferences (user configuration)
- Zero telemetry – No data is sent to any server
- Local only – Everything stays on your device
- No external connections – The app works fully offline
- Robust encryption – AES-256 for sensitive data
- Multi-layer authentication (biometric + PIN)
- Secure PIN hashing (SHA-256)
- Smart auto-lock configurable
- Integrity verification on each startup
Want to improve PsychoLogger? Contributions are welcome:
- Fork the repository
- Create a branch for your feature
- Follow Kotlin/Android conventions
- Submit your PR with a detailed description
Issues? Suggestions? Bugs?
- Open an issue on GitHub
- Contact the developer
- Check the technical documentation
When you export audio from PsychoLogger, it is encrypted using AES-256-GCM to protect your privacy.
Here is how to decrypt it:
# Install Python 3 if you don't have it
sudo apt install python3 python3-pip # Linux/Ubuntu
# brew install python3 # macOS
# Install cryptography library
pip3 install cryptography
### Decryption Commands
```bash
# Option 1: With password in the command (less secure)
python3 decrypt_psychologger.py audios_encrypted_2025-01-15.zip myPassword123
# Option 2: Without password (it will ask you for it in a hidden way - RECOMMENDED)
python3 decrypt_psychologger.py audios_encrypted_2025-01-15.zip
🔒 Password: ****- Reads the encrypted ZIP with your exported audios
- Extracts the metadata (salt, IV, PBKDF2 iterations)
- Derives the AES-256 key from your password using PBKDF2 with 120,000 iterations
- Decrypts the data with AES-256-GCM
- Extracts the audios to the
decrypted_audios/folder
# 1. Download the encrypted ZIP from your phone
adb pull /sdcard/Download/encrypted_audios_2025-01-15.zip .
# 2. Decrypt
python3 decrypt_psychologger.py encrypted_audios_2025-01-15.zip
🔒 Password: ****
# Output:
🔓 Decrypting: audios_encrypted_2025-01-15.zip
📄 Metadata:
- Algorithm: AES-256-GCM
- Iterations: 120000
- Salt: 16 bytes
- IV: 12 bytes
📦 Encrypted data: 2458930 bytes
🔑 Deriving AES-256 key with PBKDF2 (120000 iterations)...
🔐 Decrypting with AES-256-GCM...
✅ Decryption successful: 2458802 bytes
📂 Extracting audios to: decrypted_audios/
🎵 Audios found: 12
✓ audio_2025-01-10_143522.m4a
✓ audio_2025-01-11_092311.m4a
...
✅ Decryption complete!
# 3. Your audio files are in: decrypted_audios/
ls decrypted_audios/- Algorithm: AES-256-GCM (military standard)
- Key derivation: PBKDF2-HMAC-SHA256 with 120,000 iterations
- Unique salt: Randomly generated by backup
- Unique IV: Randomly generated (96 bits)
- Authentication: GCM includes integrity verification
❌ Incorrect password:
❌ ERROR: Incorrect password or corrupted data
→ Verify that the password is exactly the one you used when exporting.
❌ Library not installed:
ModuleNotFoundError: No module named ‘cryptography’
→ Run: pip3 install cryptography
Remember: This tool is designed to promote responsible use and harm reduction. Always inform yourself properly and consider the risks before experimenting with any psychoactive substance.
Developed with ❤️ for the responsible psychonaut community.