{"id":49595473,"url":"https://github.com/mvndaai/fun-sheet-music","last_synced_at":"2026-05-12T05:02:27.075Z","repository":{"id":352310950,"uuid":"1214673927","full_name":"mvndaai/fun-sheet-music","owner":"mvndaai","description":"An app for displaying colored sheet music with practice modes","archived":false,"fork":false,"pushed_at":"2026-05-04T04:31:34.000Z","size":32409,"stargazers_count":0,"open_issues_count":7,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-04T04:33:09.448Z","etag":null,"topics":["color","flutter-app","musicxml","toy"],"latest_commit_sha":null,"homepage":"http://funsheetmusic.com/","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mvndaai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"mvndaai","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":"mvndaai","thanks_dev":null,"custom":null}},"created_at":"2026-04-18T22:26:34.000Z","updated_at":"2026-05-04T04:31:38.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mvndaai/fun-sheet-music","commit_stats":null,"previous_names":["mvndaai/flutter-music","mvndaai/fun-sheet-music"],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/mvndaai/fun-sheet-music","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvndaai%2Ffun-sheet-music","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvndaai%2Ffun-sheet-music/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvndaai%2Ffun-sheet-music/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvndaai%2Ffun-sheet-music/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mvndaai","download_url":"https://codeload.github.com/mvndaai/fun-sheet-music/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvndaai%2Ffun-sheet-music/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32809213,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"online","status_checked_at":"2026-05-09T02:00:06.633Z","response_time":123,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["color","flutter-app","musicxml","toy"],"created_at":"2026-05-04T04:02:43.063Z","updated_at":"2026-05-09T06:17:10.585Z","avatar_url":"https://github.com/mvndaai.png","language":"Dart","funding_links":["https://github.com/sponsors/mvndaai","https://buymeacoffee.com/mvndaai"],"categories":[],"sub_categories":[],"readme":"# Fun Sheet Music\n\nAn app for displaying colored sheet music with practice modes.\n\n## Features\n\n- **MusicXML Support** – Upload `.xml`, `.mxl`, or `.musicxml` files from your device, or download directly from a Google Cloud Storage bucket (or any public URL).\n- **Color-Coded Sheet Music** – Notes are displayed as colored circles matching a children's xylophone (C = Red, D = Orange, E = Yellow, F = Green, G = Teal, A = Blue, B = Purple).\n- **Dual Note Names** – Toggle between letter notation (A, B, C), solfège (Do, Re, Mi), or both simultaneously.\n- **Song Library with Tags** – All uploaded songs are stored locally in a Drift database and can be organized with custom tags for easy filtering.\n- **Practice Mode (Mic \u0026 Keyboard)** – The app listens to the microphone or physical keyboard, detects the pitch/key being played, highlights the current note, and automatically advances when the correct note is heard.\n- **Tone Playback** – Play back songs using a built-in synthesizer to hear how they should sound.\n- **PDF Export \u0026 Printing** – Export your color-coded sheet music to PDF or print directly from the app.\n- **Sharing** – Share songs via QR codes or direct links.\n- **Cross-Platform** – Targets Android, iOS, and Web with platform-specific optimizations.\n\n## Getting Started\n\n### Prerequisites\n\n- [Flutter SDK](https://docs.flutter.dev/get-started/install) ≥ 3.6.0\n\n### Run\n\n```bash\nflutter pub get\nflutter run            # default device\nflutter run -d chrome  # web\n```\n\n### Build\n\n```bash\nflutter build apk          # Android\nflutter build ios          # iOS\nflutter build web          # Web\n```\n\n## Architecture\n\n```\nlib/\n├── main.dart                  # App entry point\n├── config/                    # App configuration and deep links\n├── music_kit/                 # Core music rendering \u0026 logic\n│   ├── models/                # Data structures (Song, Note, Measure, etc.)\n│   ├── widgets/               # Visual components (Staff, Note, Renderer)\n│   ├── utils/                 # Music math, PDF export, XML generation\n│   └── sheet_music_constants.dart\n├── services/\n│   ├── musicxml_parser.dart   # MusicXML → Song parser\n│   ├── database.dart          # Drift-based local database\n│   ├── storage_service.dart   # File system and preferences storage\n│   ├── pitch_detection_service.dart # Microphone capture + FFT pitch detection\n│   ├── tone_player.dart       # Synthesized note playback\n│   └── cloud_service.dart     # Remote file fetching\n├── providers/                 # State management (Song, Instrument, Keyboard)\n├── screens/\n│   ├── home_screen.dart       # Song library + tag filtering\n│   ├── sheet_music_screen.dart# Main viewer with playback \u0026 practice modes\n│   ├── upload_screen.dart     # File upload and URL import\n│   ├── instruments_screen.dart# Instrument list \u0026 selection\n│   ├── instrument_setup_screen.dart # Add/Edit instrument details\n│   └── keyboard_setup_screen.dart   # Configure key-to-note mappings\n├── widgets/                   # Shared UI components\n└── platform/                  # Platform-specific abstractions (Web vs Native)\n```\n\n## Sample Songs\n\nSeveral sample MusicXML files are included in `assets/sample_songs/`, including:\n- Twinkle Twinkle Little Star\n- Old MacDonald Had a Farm\n- Mary Had a Little Lamb\n- Concerning Hobbits\n\n## Practice Mode\n\n1. Open a song and tap **Practice**.\n2. **Microphone**: Tap the microphone button (🎙) to start listening. Play the note on your instrument – the app advances when the correct pitch is detected.\n3. **Keyboard**: Connect a physical keyboard (or use your laptop keys). The app maps keys to musical notes for silent practice.\n4. The current note is highlighted on the staff, and its name/color is shown at the top.\n5. Use the skip buttons (⏮ / ⏭) or tap notes to navigate manually.\n\n## Permissions\n\n| Platform | Permission       | Purpose                     |\n|----------|------------------|-----------------------------|\n| Android  | `RECORD_AUDIO`   | Microphone for practice mode|\n| iOS      | `NSMicrophoneUsageDescription` | Microphone for practice mode |\n| Web      | Browser mic prompt | Microphone for practice mode |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmvndaai%2Ffun-sheet-music","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmvndaai%2Ffun-sheet-music","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmvndaai%2Ffun-sheet-music/lists"}