Support & Documentation

Everything you need to know about using MindTrack for ADHD energy management and recovery.

Getting Started

First Launch

1. Download and Install: Get MindTrack from our download page
2. Grant Permissions: Allow microphone access when prompted (optional, for voice commands)
3. Choose Your Settings: Default is 25-minute focus sessions with 5-minute breaks
4. Start Your First Session: Click "Start Session" and select your work intensity

Basic Workflow

1. Click "Start Session" and select your work intensity (Light/Normal/Intense/Hyperfocus)
2. Work until the timer ends - your energy debt will be calculated
3. Check your recovery time recommendation and take appropriate rest
4. Use the "I'm Crashing" button anytime you need immediate recovery

Energy Management

Understanding Your Energy Battery

MindTrack tracks your mental energy like a battery. Every task costs energy based on its intensity, and you need recovery time to recharge.

• Green (70-100%): Fully charged! Ready for focused work
• Yellow (40-70%): Energy moderate. Consider a break soon
• Red (0-40%): Energy low. Recovery recommended!

Energy Debt Calculation

Different work types cost different amounts of energy:

• Light Work (1x): Emails, browsing, simple tasks
• Normal Work (1.5x): Regular focused work, writing
• Intense Work (2x): Meetings, complex problem-solving
• Hyperfocus (3x): Deep work, maximum concentration

Recovery Features

Crash Mode

When you're done, you're DONE. The "I'm Crashing" button activates gentle recovery mode:

• Stops any running timer immediately
• Calculates minimum recovery time (15+ minutes)
• Dims the interface to reduce stimulation
• Shows compassionate messages (no guilt)
• Starts automatic recovery timer

Recovery Activities

MindTrack suggests recovery activities based on your energy debt:

• Low Energy Debt: Scroll social media guilt-free, make tea, look out window
• Medium Energy Debt: Take a short walk, lie down for 20 mins, light stretching
• High Energy Debt: Proper break (30-60 mins), disconnect completely, take a nap

Intensity Selection

Before starting work, select your intensity level to get accurate energy tracking:

• Light: Emails, browsing, administrative tasks
• Normal: Regular focused work, writing, coding
• Intense: Meetings, complex problem-solving, presentations
• Hyperfocus: Deep work, maximum concentration, flow state

Voice Commands Reference

MindTrack responds to natural language. Just speak clearly near your microphone.

Keyboard Shortcuts

ADHD Energy Management Tips

Understanding Your Energy Patterns

• Track Your Energy: Notice when your battery is green, yellow, or red
• Respect Your Limits: Don't push through when energy is low
• Plan Recovery: Schedule recovery time like you schedule work
• Energy Debt Awareness: Understand that intense work costs more energy

Working with Hyperfocus

• Set Intensity: Mark hyperfocus sessions as "extreme" intensity
• Plan Recovery: Hyperfocus costs 3x energy - plan longer recovery
• Crash Button Ready: Keep the crash button accessible for when you're done
• No Guilt: Hyperfocus is a superpower, but recovery is necessary

Recovery Without Guilt

• Trust the Process: Recovery isn't laziness - it's brain maintenance
• Follow Suggestions: Use the recovery activity suggestions
• Crash Mode: Use crash mode when you're completely done
• Energy Awareness: Check your energy level regularly with voice commands

Troubleshooting

Voice Commands Not Working

1. Check Microphone Permission:
   • Windows: Settings → Privacy → Microphone
   • macOS: System Preferences → Security & Privacy → Microphone
   • Linux: Check your distribution's privacy settings
2. Test Microphone: Try voice commands in another app
3. Reduce Background Noise: Voice recognition works best in quiet environments
4. Use Keyboard Shortcuts: As a reliable backup

Timer Not Starting

• Ensure a previous session is fully stopped (click Stop)
• Check if app is paused (look for pause indicator)
• Restart MindTrack if issues persist

Notifications Not Appearing

1. Check system notification settings
2. Ensure MindTrack has notification permission
3. Try enabling sound alerts as alternative

Frequently Asked Questions

How does energy tracking work?

MindTrack calculates energy debt based on session length × intensity. Light work costs 1x energy, normal work 1.5x, intense work 2x, and hyperfocus 3x. Your energy battery shows remaining capacity.

What's the difference between a break and recovery?

Breaks are scheduled rest periods between work sessions. Recovery is energy restoration time calculated based on your energy debt. Recovery time is longer and more intentional than regular breaks.

When should I use crash mode?

Use crash mode when you're completely done and need immediate recovery. It's for those "I can't do anything else" moments. The app will calculate your recovery time and start a gentle recovery session.

Can I customize session lengths?

Yes! Go to Settings (gear icon) and adjust Focus Duration, Short Break, and Long Break lengths. You can set anything from 1 to 60 minutes.

Does MindTrack work offline?

Absolutely! MindTrack works completely offline. No internet connection required for any features.

How do I know if I need recovery time?

Check your energy battery - if it's yellow or red, you need recovery. You can also ask "should I rest?" and MindTrack will advise based on your current energy level.

Is recovery time really necessary?

Yes! ADHD brains need more recovery time than neurotypical brains. Recovery isn't laziness - it's necessary brain maintenance. The app helps you understand and respect your recovery needs.

How do I backup my statistics?

Stats are stored locally in your system's app data folder. You can export them from Settings → Export Data.

Is there a mobile version?

Not yet. We're focusing on desktop first since phones can be distraction triggers for ADHD. Mobile version is on our roadmap.

How do I report a bug?

Report issues on our GitHub Issues page or email write@digiwares.xyz.

Contact Support

Video Tutorials (Coming Soon)

We're creating video guides for visual learners:

• Getting Started with MindTrack (5 min)
• Customizing for Your ADHD Brain (8 min)
• Advanced Features and Tips (10 min)
• Troubleshooting Common Issues (6 min)

Community Resources

• r/mindtrack - Reddit community
• GitHub Repository - Source code and development
• Twitter Updates - News and tips