Skip to content

About

PsychoLogger is an encrypted substance tracker for Android - Safely log psychoactive experiences with offline encryption, harm reduction resources, and complete privacy.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

PsychoLogger ๐Ÿง ๐Ÿ“Š

PsychoLogger Icon

License: GPL v3 Android 8.0+ Kotlin 2.0.21 Release v1.4 Open Source Project-Based Learning 100% Offline Made with Love & Coffee

๐Ÿ‡ฎ๐Ÿ‡จ๐Ÿ‡ช๐Ÿ‡ธ Versiรณn en Espaรฑol ยท ๐Ÿ“‹ Full Changelog ยท ๐Ÿ“ฅ Download Latest APK


๐Ÿ†• What's New in v1.4

Feature Description
๐ŸŒ Full Bilingual UI (EN / ES) Complete English and Spanish localization across both native screens and the interactive interface, following your device language
๐Ÿงช 2D Molecule Icons & SMILES 86 book-oriented skeletal structures from PubChem (assets/mol/) + custom SMILES rendering (smiles-drawer + CSV column), or switch back to classic emojis in Settings โ†’ Appearance
๐Ÿ” Chunked AES-256-GCM Backups (chunked-v2) Stream-encrypts and decrypts huge photo/audio libraries in 1 MiB authenticated blocks without OutOfMemoryError, with show/hide password eye icon and 8-character minimum
๐Ÿ“ฆ Async Audio & Photo ZIP Export Background compression with a live progress bar (0/N files) and optional AES-256-GCM password encryption, without freezing the UI
โฑ๏ธ Configurable Auto-Backup & Rotation Choose how often Auto-Backup runs (6h, 12h, 24h, 48h, 7d) and how many recent backups to keep (3, 5, 7, 10, 15)
โœจ Interactive Onboarding & Smart Splash 6-slide swipeable intro guide and a neon startup animation that runs for the first 4 launches and turns itself off automatically (re-enable anytime in Settings)
๐Ÿ—ƒ๏ธ True Substance Archiving Triple-tap โ‹ฎโ‹ฎ to archive: archived substances disappear from the calendar, stats, counters, and CSV export while staying safe in backups; tap "About the project" 5 times to view/restore them
๐Ÿ›ก๏ธ Zero Internet Permission Release builds strip android.permission.INTERNET completely โ€” 100% offline, with external harm-reduction links opened via Android's system browser (ACTION_VIEW)

What is PsychoLogger?

PsychoLogger is a private, 100% offline personal logbook for psychonaut experiences and mindful substance tracking on Android. It is designed for harm reduction, self-knowledge, and responsible documentationโ€”keeping all of your entries, voice notes, and photos strictly on your device.


Why Use PsychoLogger?

๐Ÿ”’ Total Privacy (Zero Internet Permission)

  • No INTERNET permission in release builds โ€” it is physically impossible for the app to send data anywhere
  • Zero telemetry, zero analytics, zero ads
  • Biometric & App PIN lock โ€” fingerprint unlock with dedicated masked App PIN fallback
  • Authenticated encryption (AES-256-GCM + PBKDF2-HMAC-SHA256, 120,000 iterations) for full backups, voice notes, and photo exports

๐Ÿ“ Rich Experience Logging

  • Record substance, dose, custom unit, date, and exact time (including the Time Travel Picker for past entries)
  • Document your Set (mindset) and Setting (environment), and create custom tags
  • Write detailed Markdown notes (*bold*, _italic_, lists, headers)
  • Attach voice notes (built-in audio recorder/player) and photos (camera or gallery) to any entry
  • Identify substances with 2D skeletal molecules (86 built-in structures + custom SMILES support) or custom colors and emojis

๐Ÿ“ˆ Pattern Visualization & Harm Reduction

  • Interactive Monday-first Calendar with multi-substance color gradients and per-substance filtering
  • Statistics Dashboard (streaks, frequency, Set/Setting distribution, active days)
  • Direct Harm Reduction Resources โ€” quick access to Erowid, TripSit, MAPS, PsychonautWiki, DrugScience, and a curated Recommended Books library

๐Ÿ“ธ Screenshots (v1.4)

๐Ÿ  Main Screen, Calendar & Appearance Settings

Main Screen with Molecule Icons Interactive Calendar Security & Appearance Settings

๐Ÿ“Š Statistics & Context Analysis

Stats Overview Usage Frequency Set Statistics Setting Statistics

๐Ÿ”— Harm Reduction Resources, Books & Archived Substances

Harm Reduction Resources Recommended Books Archived Substances Modal

๐Ÿ’พ Data Management, Encrypted Backups & Configurable Auto-Backup

Data Management Encrypted Backup Password Configurable Auto-Backup

๐Ÿ“ฆ Manual CSV / Media Export & About the Project

CSV Export and Import Async Media Export with Progress About the Project


๐Ÿ› ๏ธ Installation & Usage

Requirements

  • Android 8.0 (API 26) or higher (targets Android 15 / API 36)
  • ~15 MB of free storage
  • Biometric sensor optional (fingerprint + App PIN supported)

How to Install

  1. Download the latest signed APK from Releases or build from source with ./gradlew assembleRelease
  2. Open the app and follow the 6-slide onboarding introduction
  3. Optional: tap the top-right โš™๏ธ gear icon to enable App Lock (Fingerprint / PIN), toggle Molecules vs. Emojis, or configure Startup Animation

Useful Gestures & Shortcuts

  • Reorder substances: drag and drop using the โ‹ฎโ‹ฎ handle on the left of each substance
  • Archive a substance: triple-tap on the โ‹ฎโ‹ฎ handle
  • View / Restore archived substances: go to the Data tab and tap the "About the project" badge 5 times

๐Ÿ”“ Decrypting Encrypted Backups, Audio & Photos (decrypt_psychologger.py)

When you export an encrypted full backup, audio ZIP, or photo ZIP from PsychoLogger, it uses AES-256-GCM (chunked-v2 streaming encryption with PBKDF2-HMAC-SHA256, 120,000 iterations). You can restore it directly inside the app or decrypt it on your computer using decrypt_psychologger.py.

1. Install Requirements

sudo apt install python3 python3-pip   # Linux / Debian / Ubuntu
# brew install python3                 # macOS
pip3 install cryptography

2. Decrypt an Exported ZIP

# Recommended: omit the password on the command line so it prompts securely
python3 decrypt_psychologger.py photos_encrypted_2026-11-07_02-10-00.zip
๐Ÿ”’ Contraseรฑa: ****

The script automatically detects whether the archive uses chunked-v2 or the legacy single-block format, verifies GCM authentication tags for every 1 MiB block, and extracts your audios/ and/or photos/ into decrypted_audios/.


๐Ÿงฑ Tech Stack

  • Kotlin 2.0.21 & Jetpack Compose (Material 3) โ€” Native security gate, biometric/PIN lock, settings overlay, SAF file management, and WorkManager periodic auto-backups
  • Hybrid WebView (assets/index.html + assets/i18n.js) โ€” Fast offline UI with local Chart.js, marked.min.js, smiles-drawer.min.js, and 86 PubChem 2D molecular SVGs (assets/mol/)
  • Streaming Cryptography (ChunkedCrypto.kt) โ€” AES-256-GCM chunked AEAD with per-chunk IV derivation and AAD framing

โš–๏ธ Harm Reduction Disclaimer

PsychoLogger is built strictly for:

  • โœ… Education and objective self-documentation
  • โœ… Harm reduction and pattern awareness
  • โœ… Privacy-preserving personal journaling

It is NOT:

  • โŒ An encouragement or promotion of substance use
  • โŒ A substitute for professional medical or psychological advice
  • โŒ Intended for minors

Developed with โค๏ธ by D4vRAM using a Project-Based Learning (PBL) approach for the responsible psychonaut community.

About

PsychoLogger is an encrypted substance tracker for Android - Safely log psychoactive experiences with offline encryption, harm reduction resources, and complete privacy.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages