ModusPractica Pro β€” User Manual
☰

1 Getting Started

ModusPractica Pro is an intelligent practice planner for musicians. Instead of repeating passages until they feel right, the app tells you exactly what to practice and when β€” based on how your brain actually consolidates motor skills.

⚠️ This app only works if you are honest with yourself. The scheduling algorithm relies entirely on the accuracy of your self-assessment β€” whether you mark a repetition as correct or failed, and how you rate your personal feeling at the end of a session. An inflated score feels good in the moment but produces an unreliable schedule and slows down your actual progress. Honest feedback, even when unflattering, is the foundation of effective practice.

Adding your first piece

Click the + button in the sidebar next to "My Repertoire". Enter the title and optionally the composer name.

Adding a section

Select your piece, then click + Add Section. A section is any fragment of music you want to practice in isolation β€” it can be as small as half a bar or as large as you find manageable. There are no rules about size: let your own experience and the difficulty of the passage guide you. Give it a name β€” this can be anything that helps you identify it: bar numbers, letter names, descriptive text, or any combination (e.g. "bars 1–4", "A-section", "maat 3 slag 3–4", "left hand only intro"). Then set a starting BPM and a target BPM.

πŸ’‘ Always include at least one beat of the following bar when defining a section. The transition into the next passage is one of the most demanding moments in motor memory β€” practicing the connection directly trains the brain to navigate it automatically.
πŸ’‘ Keep sections as small as makes sense for the passage. Some difficult passages benefit from sections as short as half a bar. The smaller and more focused the section, the more precisely the app can track and schedule your practice. You can always merge or re-divide sections as your playing develops.

Starting your first session

Sections that are due appear under Due Today on the dashboard. Click Practice to open the session page.

2 Core Concepts

Piece vs Section

A piece is a complete work (e.g. Elegy by Reinecke). A section is any fragment of that piece that you choose to practice in isolation. You decide entirely how to divide your pieces β€” there is no prescribed number of sections or minimum size. Some musicians work with two or three large sections per piece; others divide every difficult bar into its own section.

Memory Zones

Every section moves through three stages. Exploration means you are in the first two days of learning β€” the material is new and fragile. Consolidation means the section is in the spaced repetition cycle β€” the app spaces your practice to build long-term retention. Mastery means the section is fully consolidated into long-term memory.

Stability

A number that represents how many days your memory of this section will last. A stability of 5 means the app will schedule the next practice in approximately 5 days. The better you perform, the faster stability grows.

Difficulty

A score from 0 to 1 that reflects how hard this section is for you personally. It adjusts automatically based on your performance. A high difficulty slows down stability growth.

BPM Progression

You set a target tempo for each section. The app gradually increases your practice tempo as your performance improves β€” you never need to adjust the metronome manually.

Due Today

The app calculates the optimal moment for each repetition. Sections appear under Due Today when their scheduled date has arrived. Practicing earlier or later than scheduled reduces the efficiency of the spacing.

A model, not a measurement

The stability and difficulty values are mathematical approximations β€” a model of how motor memory behaves, not a direct measurement of what happens in your brain. No algorithm can measure the exact state of a synapse. The underlying principles β€” spaced repetition, rest, correct execution β€” are well supported by motor learning research. The specific numbers the app calculates are a structured, evidence-informed estimate. They are useful precisely because they are consistent and honest about what they are.

This is why your own honest self-assessment remains the most important input the app receives. The model is only as good as the data you give it.

πŸ’‘ The warning in Chapter 1 β€” "This app only works if you are honest with yourself" β€” is not a formality. It is the single most important sentence in this manual.

3 Practice Session

Training vs Analysis

A training session registers correct and failed attempts and updates the scheduling algorithm. An analysis session (πŸ”) is for free, untracked exploration β€” use it to discover fingerings, decide how to divide a piece into sections, explore phrasing, or simply read through new material without any performance pressure. It is the natural starting point before you begin structured training on a new passage.

Hands separate, hands together

When learning a new passage on a keyboard instrument, it is tempting to combine both hands as quickly as possible. Research on motor learning shows this is counterproductive: bimanual coordination is a cognitively and motorically distinct task from single-hand execution, and it requires its own acquisition phase before it can consolidate effectively (Bangert et al., 2006; Watanabe et al., 2002).

The recommended workflow in ModusPractica Pro is the following.

First, register the right hand and left hand as separate sections and use the training counter for both. Each hand executes a single, well-defined motor sequence that can be repeated correctly and counted accurately. The algorithm receives meaningful input and schedules each hand independently according to its own stability and difficulty.

Once both hands are stable individually, begin combining them. At this stage β€” and for as long as correct full repetitions cannot be reliably executed β€” use the Analysis mode (πŸ”) rather than the training counter. The counter should only register attempts that you can genuinely judge as correct or failed. If you are working through one bar at a time with both hands and the counter would remain at zero, that is a clear signal that you are still in the exploration phase, not the training phase. Saving a session with zero correct repetitions gives the algorithm incorrect input and produces an unreliable schedule.

When both hands together feel stable enough to produce correct, controlled repetitions, create a new section β€” for example "Bars 1–4 both hands" β€” and start the training counter from that point. This section will then follow its own independent spaced repetition schedule.

πŸ’‘ Practical summary: hands separate β†’ training counter. Hands together (still exploring) β†’ Analysis mode. Hands together (stable, countable) β†’ new section with training counter.

The timer

The timer measures the total duration of your session for statistical purposes only. It has no effect on your score or scheduling. There is deliberately no time pressure anywhere in this app. Practicing under time pressure raises cortisol levels and disrupts the motor consolidation processes that make practice effective. Take all the time you need between repetitions. Slow, conscious, and correct is always more valuable than fast and approximate.

Registering attempts

Use the + and βˆ’ buttons to register correct repetitions and failed attempts. A failed attempt is any execution you judge as incorrect. A correct repetition is a clean, controlled execution at the current tempo. When beginning a new section, always start at a very slow tempo β€” well below what feels necessary. Motor memory is built through correct repetition, not through speed. A single slow, perfectly controlled execution does more for long-term retention than ten rushed approximations. Speed follows naturally once the motor pattern is consolidated.

FrustrationGuard

If you accumulate too many failed attempts, the app stops the session automatically. This is not a punishment β€” frustrated practice encodes errors into muscle memory. The section is rescheduled for the next day so you return to it after a night of sleep-based consolidation. If the section keeps triggering FrustrationGuard, consider archiving it and dividing it into smaller sections. A passage that is too large or too fast to execute correctly is not ready for training β€” it needs to be broken down further.

⚠️ When FrustrationGuard triggers, do not override it. Use the remaining time for analysis or work on a different piece. Return to the section the next day β€” or consider archiving it and dividing it into smaller, more manageable fragments.

Energy level

Set your energy level before practicing. A low energy level reduces the penalty for failed attempts β€” the app recognises that fatigue is physiological, not a reflection of your motor skill.

Entry Cost

The number of failed attempts before your first correct repetition. A decreasing entry cost across sessions is one of the clearest signs that a motor skill is genuinely consolidating in long-term memory.

Notes

Use the notes field to record observations β€” fingering decisions, problem spots, tempo remarks. The most recent note is shown at the top of the next session.

Completing a session

Click Complete Session when you are done. You will be asked to confirm the outcome and to rate your personal feeling about the session: Poor, Fair, Good, or Excellent. This self-assessment is not cosmetic β€” it feeds directly into the scheduling algorithm. Your subjective experience of a session often captures information that the raw numbers do not: tension, hesitation, lack of focus, or conversely a feeling of real flow. The algorithm combines both objective performance data and your personal rating to calculate the optimal next practice date.

The app schedules one training session per section per calendar day. If you wish to practice the same section again later that day, you are free to do so β€” the session will be recorded in your statistics. The scheduling algorithm will not update a second time on the same day: your next practice date remains the one calculated after the first session.

πŸ’‘ Excellent is intentionally unavailable until you have reached the target BPM for this section. This is a deliberate design choice: the highest rating is only meaningful when the section is genuinely performable at its intended tempo. When Excellent becomes available, it is a genuine milestone β€” not just a feeling.

4 Dashboard

The dashboard is your daily starting point. Due Today shows all sections scheduled for today. Click a section to go directly to the practice session.

The sections in Due Today are ordered by priority: the most overdue section appears first, followed by sections due today. Within the same due date, sections with lower stability β€” those most at risk of being forgotten β€” are listed before more stable ones. This ordering is automatic and reflects the algorithm's assessment of what needs your attention most urgently. You do not need to reorder the list manually.

Your repertoire is listed in the sidebar. Click a piece to see its sections and their current status. Use the sort menu to order by due date, title, last practiced, or recently added.

Sections and pieces can be archived when no longer actively studied. Archived items are hidden from Due Today but their full practice history is preserved and remains visible in Statistics. Archived sections can also be permanently deleted β€” this removes the section itself but retains all recorded session data, so your practice time and history are never lost even when you clean up your repertoire.

The streak counter at the bottom of the sidebar shows your current consecutive practice days and your personal record.

5 Schedule

The Schedule page shows a calendar view of all upcoming practice sessions. Use the week selector to look 1, 2, 4 or 8 weeks ahead. Each day shows which sections are due. This helps you plan practice time and spot overloaded days in advance.

6 Statistics

Summary cards

Total Practice Time
The sum of all session durations in the selected period, split into training and analysis time.
Sessions
Total number of sessions in the selected period, split by type.
Success Rate
The percentage of correct repetitions out of total attempts across all training sessions.
FrustrationGuard
How many times the guard was triggered. A high number suggests sections may be too difficult at their current tempo.
Avg Entry Cost
The average number of failed attempts before the first correct repetition, across all training sessions. A downward trend means your repertoire is consolidating well.

Practice Time chart

A bar chart of daily practice time, colour-coded by training and analysis.

Stability Distribution

Shows how many active sections are in each stability bracket β€” a quick overview of where your repertoire stands in the learning curve.

Practice Time per Piece

A breakdown of total time, session count and average session length per piece.

Print Report

You can print or save a static practice report at any time without an AI key. This report displays your raw statistical data β€” sessions, practice time, stability and performance β€” in a clean printable format that you can analyse yourself or share with a teacher. Use the πŸ–¨οΈ Print Report button in the Statistics page to generate it.

AI Progress Report

The AI Progress Report analyses your complete practice database and generates a written report covering consistency, tempo trends, sections that need attention, and three concrete action points. The AI does not replace the statistics β€” it reads and interprets them, providing context and advice that the numbers alone cannot give.

The report requires a personal Groq API key, configured in Settings. Groq was chosen specifically because it uses a pay-per-use model β€” you only pay for what you actually use, and the cost per report is extremely small (typically a fraction of a cent). You can monitor your exact usage and costs at any time on the Groq console (console.groq.com) .

The AI feature is entirely optional. ModusPractica Pro is fully functional without it β€” the report is a valuable addition for users who want a deeper interpretation of their data, but it is never required for normal use.

πŸ’‘ How to get a Groq API key: Go to console.groq.com and create a free account. Once logged in, navigate to API Keys in the left menu and click Create API Key. Copy the key (it starts with gsk_) and paste it into the Groq API Key field in ModusPractica Pro Settings. Your key is stored only in your browser's session memory and is automatically cleared when you close the browser β€” it is never sent to any server other than Groq's own API.

7 Settings

Backup & Restore

Export all your data as a JSON file at any time. This file can be reimported to restore your data or transfer it to another device.

⚠️ Data is stored locally in your browser and is not backed up automatically. Export regularly to avoid data loss.

Import from Lite

If you have a ModusPractica Lite backup, you can import it here. Your pieces and sections are reconstructed automatically. Note that Lite sessions do not contain individual attempt counts β€” these fields will be set to zero after migration.

Groq API Key

Enter your personal Groq API key to enable the AI Progress Report in Statistics. Groq uses a pay-per-use pricing model β€” the cost per report is extremely small and you only pay for what you use. Monitor your usage at console.groq.com . Your key is stored in session memory only and is cleared automatically when you close the browser. It is never stored permanently or transmitted to any server other than Groq.

πŸ’‘ In a future version of ModusPractica Pro, an option will be available to store your API key permanently in the browser on your own trusted machine. For now, the key is cleared on every browser close as a deliberate security measure β€” your key is never stored in a database or transmitted to any server other than Groq's own API.

Reset App

Permanently deletes all data. Always export a backup before using this option.

Your Browser, Your Data

ModusPractica Pro stores all data locally in your browser using IndexedDB. There is no cloud server, no account, and no synchronisation. This is a deliberate choice that keeps your data private and under your full control β€” but it comes with one important consequence: your data lives in the browser you use.

Choose one browser and use it consistently for all your practice sessions. If you switch to a different browser on the same machine, or move to a different device, your data will not be there β€” unless you explicitly transfer it via an export file.

To move your data to another browser or device: export a backup in Settings, then open ModusPractica Pro in the new browser or device and import that file. Once you have verified the import, use Danger Zone β†’ Reset App on the old browser to remove the duplicate.

You can store your exported backup file in your own cloud storage (Google Drive, iCloud, Dropbox, or any service you trust) so that it is accessible from anywhere. This gives you the flexibility of working across machines while keeping full control of your data.

⚠️ Back up after every practice session. Because all data is stored locally in your browser, it cannot be backed up automatically β€” browser security restrictions prevent any app from writing files to your disk without your explicit action. If your browser data is cleared, the device fails, or you accidentally reset the app, any sessions since your last export will be lost permanently. The export takes only a few seconds. Make it a habit.

8 Tips for Music Teachers

ModusPractica Pro is well suited for use in a teaching context. Here are some practical guidelines.

Keep sections small

Smaller sections allow more precise tracking and more targeted repetition. Do not feel constrained by bar boundaries β€” a difficult section can be as short as half a bar or even a single beat. The more focused the section, the more efficiently the app can schedule and track it. You can always expand or re-divide sections as your playing develops.

Set realistic BPM targets

The target BPM should be the final performance tempo, not a practice tempo. The app manages the gradual build-up automatically.

Keep the gap between start and target BPM manageable. A starting tempo of 30 BPM with a target of 100 BPM creates a gap that the algorithm will bridge gradually, but the intermediate steps may feel disconnected from musical reality. A practical rule: if the gap exceeds 40 BPM, consider setting an intermediate target first β€” for example 60 BPM β€” and raising it once that tempo is consolidated. The app does not enforce this; it is a pedagogical decision that remains with the user.

Use Analysis mode first

Before the first training session on a new section, use the Analysis (πŸ”) mode to explore the passage freely. This gives the student a mental map before the counting begins.

Teach the hands-separate workflow explicitly

Students who are not guided on this point will instinctively try to combine both hands too early. Make the workflow explicit from the first lesson: right hand and left hand are registered as separate sections and trained independently until both are stable. Only then does the student switch to Analysis mode for the combined version, and only when full repetitions are reliably correct does a new "both hands" section get created. This structure prevents the common error of saving sessions with zero correct repetitions, which corrupts the scheduling data.

Explain the Memory Zones to students

Students who understand why the app schedules repetitions the way it does are more likely to trust the system and follow it consistently.

Respect the FrustrationGuard

When the guard triggers, do not override it. Use the remaining lesson time for analysis or work on a different piece. Return to the section in the next lesson.

Check Statistics together

The Statistics page is a useful tool for lesson conversations β€” success rate, entry cost trends and stability distribution give objective data to discuss progress.

9 Practice Tips

The following tips are grounded in motor learning research and complement the algorithm. They are practical suggestions, not requirements β€” the app works without them. But applied consistently, they can meaningfully improve the quality of each session.

Take a short rest between repetitions

Research suggests that brief pauses between repetitions support motor memory consolidation. A landmark study found that performance improvements during motor skill learning develop almost exclusively during short rest periods between practice bouts β€” not during the practice itself. During these pauses, the brain appears to replay recently practised movement sequences, a process linked to the strengthening of motor memory traces (BΓΆnstrup et al., 2019, Current Biology).

In practice: after completing a repetition, pause briefly, release any physical tension, and allow a few seconds of stillness before attempting the next one. Resist the urge to immediately analyse what went wrong β€” passive rest appears more beneficial than active cognitive processing during these micro-intervals.

πŸ’‘ Note: The exact mechanism behind these short-rest benefits remains an active area of debate. Some recent studies suggest that the performance gains observed immediately after a rest period may reflect motor pre-planning rather than true memory consolidation, and may not persist in the long term (Aarts et al., 2025, PNAS). The practical advice to pause between repetitions remains sound regardless of the mechanistic interpretation.

Practice in the evening, sleep, improve in the morning

Sleep is not merely rest β€” it is an active consolidation process for motor memory traces. Research using piano-type finger sequences has shown that subcortical brain regions involved in motor learning strengthen their mutual connections during sleep, producing measurable improvements in accuracy and timing the following morning β€” without any additional practice (Walker et al., 2002, Neuron; Debas et al., 2014, NeuroImage).

Two practical consequences follow. First: a section that still feels rough at the end of a session may feel noticeably cleaner the next morning β€” this is not coincidence but biology. Second: practicing shortly before going to sleep is particularly efficient, because consolidation begins immediately during the first sleep cycle.

This is also why ModusPractica never schedules a section twice on the same calendar day. The algorithm treats one night of sleep as the minimum unit of consolidation β€” a design choice directly grounded in the research above. You are always free to practice a section a second time on the same day on your own initiative. The additional session will be recorded in your statistics, but the scheduling algorithm will not be updated a second time: the next practice date calculated after your first session of the day remains unchanged.

πŸ’‘ A nap of 60–90 minutes produces a comparable consolidation effect to a full night of sleep for recently learned motor material (Korman et al., 2007, Nature Neuroscience). This duration is sufficient to include the deeper sleep stages needed for full motor consolidation. Shorter naps improve alertness but may not provide the complete consolidation benefit. Results are less consistent than for overnight sleep, but the evidence is sufficient to recommend a nap after an intensive practice session when a full night of sleep is not yet available.