| Feature | Description |
|---|---|
| ⏰ Time Travel Picker | Log forgotten experiences with visual calendar and quick date buttons (Yesterday, 2 days ago, etc.) |
| 🔀 Drag & Drop | Reorder your substance list by dragging |
| 📦 Archive Substances | Triple-tap on ⋮⋮ to hide substances without losing records |
| 🧹 Data Cleanup Tool | Scan and fix corrupted entries in Settings > Data |
| ⏱️ Precise Time Input | 1-minute increments + direct keyboard entry |
| 📂 Improved CSV Import | Now works with all file managers |
| 🔗 GitHub Button | Quick access to repository from About section |
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 custom sets and settings to your apk.
- Add personal daily notes with each entry, and/or use it as a complementary “psychonaut diary”. Markdown buttons and format are implemented on them.
- Audio record and pictures uploads/camera are available to save and able to use in personal notes.
- 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
⚠️ This is the only reason why the apk requests Internet permissions. You can recompile it on your own (always following the license guidelines) and remove the redirection to the websites that I considered appropriate, thus dispensing with the Internet permission.- 🤔 I kindly encourage skeptics to search the source code or send it to any AI, and they will find that what I say is true.
- 🗣 I understand that Internet permissions in this application may raise some eyebrows, given the necessary and intrinsic privacy that a personal registration app of any kind requires.
- 🔎 In addition to encouraging you to look at the code and/or send it to any AI to review the entire source code, I also encourage you, if you still have any reservations, to choose one of these two options: block the app's Internet permissions if your mobile operating system allows it.
- If not, I recommend Netguard: open source, reliable, space-efficient, and effective.
‼️ Ultimately, if there are users who want to use the app and would use it if it weren't for this, please open an issue and let me know that despite everything I've said, you still consider it a problem for your privacy. At the moment, the only Internet permission required by the application is link redirection, although I have future plans to be able to link data to the cloud perhaps later on. For now, I wanted to make this clear ✍️📌
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 8.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 15 (API 36)
- Minimum: Android 8.0 (API 26)
- 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.