"Use at your own risk."
Receipts is a fully Free and Open Source (FOSS) Android application for documenting life's little (and big) moments with timestamped photo and video evidence. It is built on a philosophy of accountability and constructive communication, featuring a unique "Moral Mechanic" system that balances chaotic tracking with positive reinforcement.
- Receipts Mode (Chaotic/Accountability): The "Evidence Room" vibe. Document everything with a raw, high-contrast aesthetic.
- Littles Mode (Wholesome/Constructive): A pastel, journaling aesthetic focused on "Little things that build up." Integrated with AI coaching to help you talk through friction points.
- Evidence Locker: Store photo and video receipts locally. Your data never leaves your device unless you choose to export it.
- Auto-Avatar: "You are what you do." Your profile picture is automatically set based on your most frequent activity category.
- Achievements: Earn badges ranging from "First Case" to "Internal Affairs" (30-day streak).
- AI Coaching: Get empathetic, practical advice on how to bring up sensitive topics without escalating into an argument.
- Loot Boxes: Redeem Redemption Credits (earned by logging positive receipts) to make embarrassing or shameful receipts disappear from your feed.
- Uno Reverse: If someone blasts you with evidence, hit back with your own if you've tracked enough of their "receipts."
- Expose: Generate cinematic hype/shame compilation videos using FFmpeg when a pattern of behavior (50+ receipts) is established.
Unlike traditional apps, all features in Receipts are free. However, "Advanced" features are governed by Moral Limits to maintain the app's integrity:
- Redemption Credits: Loot Boxes are "purchased" using credits earned by catching people being good (Positive Receipts).
- Daily Advice Limit: AI coaching is limited to 3 sessions per day to encourage deep reflection over impulsive use.
- Investigation Focus: Limit of 5 tracked persons to ensure the app stays focused on core relationships.
- Expose Cooldown: A 30-day cooldown and a 50-receipt threshold for video generation to keep "The Finale" meaningful.
This project is designed for Reproducible Builds.
- Deterministic: Gradle is configured to produce bit-for-bit identical APKs regardless of the build environment.
- F-Droid Compatible: No proprietary SDKs (Maps, Billing, or Analytics).
- Verify: You can compare the hash of the GitHub Release APK with your local build to ensure the binary matches the source.
- Clone the repository.
- Open in Android Studio (Koala or newer).
- Build and run.
- (Optional) Provide your own Gemini API key in Settings for AI Coaching.
- Bugs/Features: GitHub Issues
- Direct Contact: email
- Security: See SECURITY.md
MIT License - See LICENSE for details.
Built with vibes, launched with consequences.