How migawari0202-cpu/homemascotforge works
HomeMascot is an Android home-screen mascot widget combining character-driven speech and visuals with time, weather, battery, and memos; it also provides clock mode and character installation. The documented user flow is adding the widget, selecting or installing a character, and viewing or interacting with its changing information. README statements support the main feature branches; sampled code confirms memo persistence and battery-update handling. Most UI, character, weather, and widget orchestration files were not sampled, so those links are documented or left unverified rather than presented as inspected calls.
Main entry points: DynamicCharacter.kt Character runtime · MemoRepository.kt Memo repository · TimeWidgetProvider.kt Home widget · MemoDao.kt Memo DAO
Components 25
Widget and clock
- Home widget
app/src/main/java/com/example/mascotforge/widget/TimeWidgetProvider.kt - Widget updates
app/src/main/java/com/example/mascotforge/widget/WidgetUpdateCoordinator.kt - Update scheduling
app/src/main/java/com/example/mascotforge/widget/WidgetUpdateScheduler.kt - Clock mode
app/src/main/java/com/example/mascotforge/ClockActivity.kt
Character runtime
- Character selection
app/src/main/java/com/example/mascotforge/CharacterSelectorActivity.kt - Character management
app/src/main/java/com/example/mascotforge/CharacterManager.kt - Character runtime
app/src/main/java/com/example/mascotforge/character/DynamicCharacter.kt - Speech rules
app/src/main/java/com/example/mascotforge/SpeechManager.kt - Speech parsing
app/src/main/java/com/example/mascotforge/speech/Tagparser.kt - Built-in character
app/src/main/assets/characters/default_character/character.json
Character installation
- Install screen
app/src/main/java/com/example/mascotforge/ui/theme/components/CharacterInstallActivity.kt - Character installer
app/src/main/java/com/example/mascotforge/installer/CharacterInstaller.kt - ZIP validation
app/src/main/java/com/example/mascotforge/installer/ZipSecurityValidator.kt - Character editor
HomeMascotForge-editor.html
Data and services
- Weather service
app/src/main/java/com/example/mascotforge/weather/WeatherRepository.kt - Weather refresh
app/src/main/java/com/example/mascotforge/WeatherUpdateWorker.kt - Battery cache
app/src/main/java/widget/cache/BatteryManager.kt - Battery receiver
app/src/main/java/widget/cache/BatteryReceiver.kt - Memo screens
app/src/main/java/com/example/mascotforge/MemoInputActivity.kt - Memo cache
app/src/main/java/widget/cache/MemoCache.kt - Memo repository
app/src/main/java/widget/database/MemoRepository.kt - Memo DAO
app/src/main/java/widget/database/MemoDao.kt - Memo database
app/src/main/java/widget/database/MemoDatabase.kt - Memo records
app/src/main/java/widget/database/MemoEntity.kt
Other components
- Android user
Connections 23
- Android user → Home widget: adds and views
README.md - Android user → Character selection: selects character
README.md - Android user → Install screen: opens character ZIP
README.md - Android user → Clock mode: opens clock mode
README.md - Home widget → Widget updates: requests updates
- Update scheduling → Widget updates: schedules refresh
README.md - Character selection → Character management: chooses character
- Character management → Character runtime: loads character
README.md - Character runtime → Built-in character: reads assets
README.md - Character runtime → Speech rules: evaluates speech
README.md - Speech rules → Speech parsing: parses tags
README.md - Install screen → Character installer: starts install
README.md - Character installer → ZIP validation: validates archive
README.md - Character editor → Android user: creates character
README.md - Weather refresh → Weather service: fetches weather
README.md - Battery receiver → Battery cache: updates cache
app/src/main/java/widget/cache/BatteryReceiver.kt - Battery receiver → Home widget: requests refresh
app/src/main/java/widget/cache/BatteryReceiver.kt - Memo screens → Memo cache: manages memos
README.md - Memo cache → Memo repository: delegates memo access
app/src/main/java/widget/cache/MemoCache.kt - Memo repository → Memo database: opens database
app/src/main/java/widget/database/MemoRepository.kt - Memo database → Memo DAO: provides DAO
app/src/main/java/widget/database/MemoDatabase.kt - Memo repository → Memo DAO: reads and writes
app/src/main/java/widget/database/MemoRepository.kt - Memo DAO → Memo records: queries records
app/src/main/java/widget/database/MemoDao.kt