Skip to content

Adithya-Jayan/MyRepertoirApp

Repository files navigation

Hacktoberfest 2025

Build Status Nightly Status

Github All Releases Github Lastest Releases

License

Repertoire logo

Repertoire: Music Practice & Sheet Music Organizer

Download Latest Release | Download Nightly Build | Download from F-Droid | View the Webpage

Repertoire is an app designed for musicians, dancers, magicians, or performers to help manage their repertoire, track practice sessions, and organize all related media in one place.

Keep your sheet music, notes, audio recordings, videos, links, and practice logs neatly organized for every piece in your collection.

Getting Started

Installation

Just want to use the app on Android? Follow our Step-by-Step Installation Guide.

Currently available for Android. A web version is available in the Nightly Builds, and support for Windows, macOS, and Linux is planned for the future.

Quick Overview

Once installed, you can:

  1. Add your music pieces, dance routines, or other performance pieces
  2. Attach sheet music (PDFs), notes, audio files, videos, and images
  3. Track your practice sessions
  4. Search and filter your collection by tags, genre, or practice history
  5. Backup your entire library

Key Features

Repertoire Library

  • View your collection in list or grid format
  • Each piece shows title, artist/composer, and custom tags

Media Attachments

  • PDFs for sheet music (viewable in-app)
  • Markdown notes for annotations and lyrics
  • Images for reference photos
  • Audio files with speed control and pitch shifting
  • Video links to YouTube or other resources

Practice Tracking

  • Log practice sessions for each piece
  • See when you last practiced
  • Track total practice sessions
  • Filter pieces by practice history

Organization

  • Search through titles, composers, and tags
  • Filter by genre, difficulty, and custom tags
  • Sort by name or longest since practice
  • Group and categorize your pieces

Backup & Restore

  • Manual backup to a single file
  • Automatic periodic backups
  • Choose your backup location
  • Restore from previous backups

Screenshots

Gallery View

Create a gallery of all your pieces

Piece gallery view List layout view

Media & Practice

Attach all relevant media and track practice sessions

Media attachments interface Practice tracking interface

Organization & Sorting

Group your pieces and tag them as you wish

Piece organization Sorting options

Customization & Backup

Personalize your experience and keep your data safe

Customization settings Backup and restore

Frequently Asked Questions

Where is my data stored?

  • All your data is stored locally on your device in a private app directory. You can export backups at any time.

How do I backup or restore my data?

  • Go to Settings > Backup & Restore. You can create manual backups or restore from a previous backup file. Automatic periodic backups are also supported.

What platforms does the app support?

  • Currently available for Android. Support for web, Windows, macOS, and Linux is planned for the future.

Contributing

We welcome contributions from everyone! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.

Hacktoberfest 2025

Hacktoberfest 2025

We are participating in Hacktoberfest! Look for the hacktoberfest and good first issue labels in our issues tab.

How to Contribute

Please read our Contributing Guidelines before getting started.

For Developers:

  1. Clone the repository:

    git clone https://github.com/Adithya-Jayan/MyRepertoirApp.git
  2. Navigate to the project directory:

    cd MyRepertoirApp
  3. Install dependencies:

    flutter pub get
  4. Run the app:

    flutter run

Prerequisites: Ensure you have the Flutter SDK installed. See the official Flutter installation guide.

Project Structure

lib/
├── database/     # Database helper and schema
├── models/       # Core data models (MusicPiece, MediaItem, etc.)
├── screens/      # UI for each screen of the app
├── services/     # Business logic for services
├── utils/        # Utility functions and constants
├── widgets/      # Reusable custom widgets
└── main.dart     # App entry point

Tech Stack

  • Flutter (Dart)
  • SQLite (local storage)
  • just_audio, video_player (media playback)
  • Provider (state management)
  • Other libraries: file_picker, share_plus, url_launcher, etc.

Credits

Thank you to all the people who have contributed! (Please contribute to help improve the app 🥺)

MyRepertoir app contributors

Made with contrib.rocks.

Support & License

For help, bug reports, or feature requests, open an issue.

Distributed under the Apache 2.0 licence. See NOTICE and LICENSE for more information.