Troubleshooting

Having issues with CueCapture? This guide covers common problems and their solutions.

Connection Issues

Notion Connection Failed

Symptoms:

• “Unable to connect to Notion” error
• Tasks not loading
• Sync icon shows error

Solutions:

1. Check internet connection

   Ensure you’re connected to the internet.

2. Verify API key

   • Go to Settings → Notion Databases
   • Click “Verify” next to your API key
   • If invalid, get a new key from notion.so/my-integrations

3. Check database sharing

   • Open your database in Notion
   • Click ”…” → “Connections”
   • Verify your integration is listed

4. Restart CueCapture

   Close and reopen the app to reset connections.

Tasks Not Syncing

Symptoms:

• Changes in CueCapture don’t appear in Notion
• Changes in Notion don’t appear in CueCapture

Solutions:

1. Manual refresh: Press Ctrl/Cmd + R
2. Check sync status: Look for error icons
3. Verify permissions: Integration needs read/write access
4. Check filters: Your filter might be hiding tasks

Sync Is Slow

Possible causes:

• Large database (1000+ tasks)
• Slow internet connection
• Many concurrent changes

Solutions:

• Increase sync interval in Settings → Sync
• Archive completed tasks in Notion
• Use filters to reduce loaded tasks

Widget Issues

Widget Not Appearing

Solutions:

Windows

1. Check system tray for CueCapture icon
2. Try the global shortcut: Ctrl + Shift + Space
3. Check if another app is blocking the window
4. Restart CueCapture

macOS

1. Check menu bar for CueCapture icon
2. Try the global shortcut: Cmd + Shift + Space
3. Check System Preferences → Security for permissions
4. Restart CueCapture

Widget Stuck Off-Screen

If the widget moved off your visible screen:

1. Open Settings → Preferences → Widget
2. Click “Reset Position”
3. Widget returns to center of main screen

Or press Ctrl/Cmd + Shift + R to reset position.

Widget Too Small/Large

1. Settings → Preferences → Widget → Size
2. Adjust width and height
3. Or drag widget edges to resize

Global Shortcut Not Working

1. Check for conflicts: Another app may use the same shortcut
2. Verify shortcut: Settings → Shortcuts
3. Try different shortcut: Customize if needed
4. Restart CueCapture: To re-register shortcuts

Time Tracking Issues

Timer Not Saving

Solutions:

1. Ensure Time Logs database is connected
2. Check property mappings in settings
3. Verify you clicked “Stop” not “Discard”
4. Check for sync errors

Duration Wrong

Possible causes:

• Timezone mismatch
• Timer was paused
• Manual edit error

Solutions:

1. Check timezone settings on your computer
2. Edit the time log to correct duration
3. Verify start and end times

Time Logs Not Syncing to Notion

1. Verify Time Logs database is connected
2. Check all required properties are mapped
3. Ensure “Include time” is enabled on date properties
4. Try manual sync

Voice Issues

Microphone Not Working

1. Check permissions

   • Windows: Settings → Privacy → Microphone
   • macOS: System Preferences → Security → Microphone

2. Select correct microphone

   • Settings → Voice Assistant → Microphone
   • Choose your microphone from dropdown
   • Test with “Test” button

3. Try different speech mode

   • Browser Speech, Whisper, or Deepgram
   • Some work better with certain mics

Poor Voice Recognition

Solutions:

1. Speak closer to microphone
2. Reduce background noise
3. Try Whisper or Deepgram mode (more accurate)
4. Speak at normal pace (not too fast)

Voice Commands Not Recognized

• Commands work best with Whisper or Deepgram
• Try explicit phrasing: “Add task…”
• Check Settings → Voice Assistant → Commands

Performance Issues

CueCapture Running Slowly

Solutions:

1. Reduce loaded tasks

   • Enable “Exclude completed tasks”
   • Use filters to load fewer tasks

2. Check memory usage

   • Close other heavy applications
   • Restart CueCapture periodically

3. Disable unused features

   • Turn off features you don’t use
   • Reduces background processing

High CPU Usage

Possible causes:

• Continuous sync issues
• Voice always-listening mode
• Large database processing

Solutions:

1. Increase sync interval
2. Disable auto-listen mode
3. Archive old tasks in Notion
4. Restart CueCapture

Startup Is Slow

Solutions:

1. Reduce initial task load (use filters)
2. Disable “Show completed tasks” by default
3. Check if antivirus is scanning the app
4. Ensure SSD (not HDD) if possible

Cloud Sync Issues

Cloud Sync Not Working

1. Verify subscription is active
2. Check you’re signed into correct account
3. Click “Sync Now” to force sync
4. Check internet connection
5. Sign out and back in

Settings Not Appearing on New Device

1. Ensure same account on both devices
2. Wait for sync to complete (may take 30 seconds)
3. Try “Sync Now” on both devices
4. Check for sync errors in settings

Conflict Errors

When settings conflict between devices:

1. CueCapture shows conflict dialog
2. Choose which version to keep
3. Or: sync the device with correct settings first

Installation Issues

Windows SmartScreen Warning

This is normal for unsigned apps:

1. Click “More info”
2. Click “Run anyway”
3. App is safe and open source

macOS “Unidentified Developer”

1. Right-click the app
2. Select “Open”
3. Click “Open” in the dialog
4. Only needed once

Update Failed

1. Download latest version manually from GitHub
2. Install over existing version
3. Settings are preserved

Data Issues

Tasks Duplicated

Causes:

• Sync conflict
• Database restored from backup
• Multiple imports

Solutions:

1. Delete duplicates in Notion
2. CueCapture will sync deletions
3. Avoid importing while syncing

Tasks Missing

Check:

1. Filter settings (may be hiding tasks)
2. Task exists in Notion
3. Database is shared with integration
4. Task wasn’t recently completed

Settings Lost

If settings disappeared:

1. Check if you signed out of cloud sync
2. Restore from backup: Settings → Data → Restore
3. Re-configure if needed

Getting More Help

Check Logs

CueCapture logs errors for debugging:

• Settings → About → “View Logs”
• Logs show recent errors and sync activity

Reset CueCapture

As a last resort, reset to defaults:

1. Settings → Data → “Reset All Settings”
2. You’ll need to reconfigure Notion connection
3. Cloud sync settings preserved (if signed in)

Report a Bug

If you can’t resolve the issue:

1. Settings → About → “Report Bug”
2. Include steps to reproduce
3. Attach logs if possible

Contact Support

• Free users: GitHub issues
• Pro users: Priority email support
• Pro+: Direct developer contact

Next Steps

• FAQ - Common questions
• Keyboard Shortcuts - Navigation help
• Installation - Reinstall if needed