Skip to content

Hotaro26/Mascot

Repository files navigation

mascot_icon

Mascot

sup! welcome to Mascot (formerly mastco/matco) — it's basically this evil open-source alarm app I made that literally forces you out of bed. if you're the type to snooze 50 times and end up late to everything, you kinda need this.

Mascot makes you do annoying stuff like solving math problems, scanning random QR codes, or even walking to your bathroom to take a picture of your sink just to turn off the alarm. the AI object detection is all on-device so it's super fast and doesn't steal your data.

Key Features (Why this app is truly evil)

  • Invincible Mode: it uses Device Administrator privileges so you literally can't uninstall the app while the alarm is blasting. nice try though.
  • Anti Power-Off: leverages Accessibility Services to block you from turning off or restarting your phone when the alarm goes off. you are trapped.
  • 4 Wake-up Challenges:
    • Math: solve basic to hardcore math equations.
    • Puzzles: a lot of fun puzzles which actually forces your brain to get out of that unconcious state
    • QR Code: print a QR code, stick it in your bathroom, and go scan it to shut the alarm up.
    • Flashbang: literally blinds you with a bright flashing screen (you can double-tap to dismiss if you're weak).
    • AI Object Detection: forces you to get out of bed and take a picture of a random object (like a chair, toothbrush, grass, or even your cat).
  • Predictive Back Gestures & Minimalist UI: built with Jetpack Compose Material 3, squishy cards, custom mascot icons, and a super clean dark mode.
  • Strict Mode: locks down your alarm settings so you can't cheat and change the time 5 minutes before it rings.

oh, and if you hate oversleeping and actually find this app useful, dropping a star on the repo would be sick.

Screenshots

Screenshot_20260711-215802_mascot Screenshot_20260711-215807_mascot Screenshot_20260711-182217_mastco Screenshot_20260711-182400_mastco Screenshot_20260711-182600_mastco
Screenshot_20260711-203449_System UI Screenshot_20260711-215726_mascot Screenshot_20260711-215730_mascot Screenshot_20260711-215735_mascot Screenshot_20260711-215739_mascot

Tablet ui

Screenshot_20260711-220644_mascot Screenshot_20260711-220540_mascot Screenshot_20260711-220556_mascot
Screenshot_20260711-220609_mascot Screenshot_20260711-220629_mascot Screenshot_20260711-220637_mascot

What's under the hood?

I built this thing using some pretty cool stuff:

  • Kotlin & Jetpack Compose: all the UI is modern and smooth (the cards even get squishy when you press them).
  • Google ML Kit: handles all the on-device AI for object detection (like recognizing your toothbrush) and QR scanning offline!
  • Room Database: saves your alarms locally.
  • Coroutines & Services: keeps the alarm and timers running perfectly in the background so you can't escape it.

How to build it locally

if you wanna mess with the code or build it yourself, it's super easy.

  1. clone the repo:
    git clone https://github.com/Hotaro26/Mascot.git
    cd Mascot
  2. open the project in Android Studio (or whatever you use).
  3. let Gradle sync all the dependencies.
  4. hit the run button or build an APK from the command line:
    ./gradlew assembleDebug
  5. install the APK on your phone and try not to throw it at a wall when the alarm goes off.

Contributing

wanna add a new feature or fix a bug? bet. i'm totally down for pull requests.

  1. fork the repo.
  2. create a new branch (git checkout -b feature/your-cool-idea).
  3. make your changes and commit them.
  4. push to your fork and open a PR.

just make sure your code isn't super messy and you're good to go.

Localization:

Help translate the Mascot App on Crowdin

License

Mascot is licensed under the MIT License. do whatever you want with the code, just don't blame me if you still sleep through your math problems.

Star History

Star History Chart

Releases

Contributors

Languages