Skip to main content

Settings

Customize Vigilare to match your workflow. Access all preferences through the Settings window and configure everything from window behavior to list archiving.

Accessing Settings​

Multiple ways to open preferences.

From Main Window​

Settings Button:

  • Look for ⚙ (gear) icon in window title bar
  • Click to open Settings window
  • Fastest method when window visible

Keyboard Shortcut​

⌘, (Command + Comma)

  • Standard macOS settings shortcut
  • Works when Vigilare window focused
  • Opens Settings immediately

Settings Window Layout​

Understanding the settings organization.

Tab Structure​

Sidebar Navigation:

  • Left sidebar with tab icons
  • Click tab to switch views
  • Right side shows selected tab content
  • Clean, organized interface

Available Tabs:

  1. General: Core app settings
  2. Lists: Archive management
  3. Shortcuts: Keyboard shortcut reference
  4. Feedback: Send suggestions/bugs
  5. About: App information and credits

Window Size​

Fixed Dimensions:

  • Settings window opens at predefined size
  • Not resizable (by design)
  • Optimized for all settings to fit
  • Consistent experience

General Settings​

Configure core app behavior and window management.

Launch at Login​

What It Does:

  • Starts Vigilare automatically when you log in to macOS
  • App launches in background
  • Window appears in last position
  • Reminders visible immediately

How to Enable:

  1. Settings → General tab
  2. Find "Launch at Login" option
  3. Check the checkbox
  4. Change applies immediately

When to Use:

Daily Vigilare Users:
- Check tasks every morning
- Want reminders always visible
- Forget to launch apps manually
→ Enable launch at login

Occasional Users:
- Only need Vigilare sometimes
- Prefer manual launch
- Minimize startup apps
→ Keep disabled

Technical Note:

  • Uses macOS launch agents
  • Doesn't slow down login
  • Can disable anytime
  • No persistent background processes

Window Level​

Three Options:

  • Always on Top (Floating)
  • Normal
  • Desktop

See detailed explanation in Window Management → Window Levels

Quick Summary:

Always on Top:

  • Window stays above all others
  • Perfect for fullscreen work
  • Never gets hidden

Normal:

  • Standard window behavior
  • Can be covered by other windows
  • Good for multitasking

Desktop:

  • Sits below all windows
  • Visible when desktop shown
  • Minimal intrusion

How to Change:

  1. Settings → General
  2. Find "Window Level" section
  3. Select radio button for preferred level
  4. Change applies immediately
  5. No restart needed

Space Display​

Two Options:

  • All Spaces: Window visible on every Space
  • Current Space Only: Window stays on one Space

See detailed explanation in Window Management → Multi-Space Support

Quick Summary:

All Spaces:

  • Window follows you between Spaces
  • Always visible
  • Good for constant task awareness

Current Space Only:

  • Window stays on creation Space
  • Disappears when switching Spaces
  • Good for dedicated workspaces

How to Change:

  1. Settings → General
  2. Find "Space Display" section
  3. Select radio button
  4. Requires app restart
  5. Quit and relaunch Vigilare

Important: Space display changes require app restart to take effect.

Lists Settings​

Manage which lists appear in Vigilare.

Archive Management​

Purpose:

  • Hide completed or inactive lists
  • Reduce clutter in list dropdown
  • Keep lists in Apple Reminders
  • Nothing is deleted

Interface:

  • List of all your Reminders lists
  • Toggle switch for each list
  • ON = Active (visible in Vigilare)
  • OFF = Archived (hidden from Vigilare)

How to Archive a List:

  1. Settings → Lists tab
  2. Find list you want to archive
  3. Toggle switch to OFF
  4. List immediately hidden from Vigilare
  5. Still exists in Apple Reminders

How to Unarchive:

  1. Settings → Lists tab
  2. Find archived list (toggle OFF)
  3. Toggle switch to ON
  4. List immediately appears in Vigilare
  5. All tasks still intact

See detailed explanation in List Management → Archiving Lists

What Archiving Affects​

In Vigilare:

  • List removed from dropdown
  • Tasks not shown in "All" view
  • Search doesn't include archived tasks
  • Reduces visual clutter

In Apple Reminders:

  • List completely unchanged
  • All tasks still visible
  • Still syncs normally
  • Other devices not affected (unless also using Vigilare)

Common Archive Scenarios​

Completed Projects:

Project Alpha finished:
1. Mark all tasks complete in list
2. Settings → Lists
3. Archive "Project Alpha"
4. List hidden from Vigilare
5. Reference available in Reminders if needed

Seasonal Work:

Tax preparation:
- Archive after April
- Unarchive next January
- Tasks preserved
- Reduces year-round clutter

Inactive Clients:

Client on hold:
- Archive client list
- Cleans up active lists
- Easy to unarchive when project resumes

Shortcuts Reference​

View all keyboard shortcuts with descriptions.

Shortcut Categories​

Organized by Function:

  • Window: Control window visibility
  • Editing: Format and save content
  • List Navigation: Browse tasks
  • Reminder Management: Task actions

Each Shortcut Shows:

  • Key combination (visual)
  • Action description
  • Context where it works

Read-Only:

  • Cannot customize shortcuts (fixed)
  • Reference only
  • Copy or screenshot for quick reference

See complete guide in Keyboard Shortcuts

Example Shortcuts Displayed​

Window Control:

  • ⌘E: Iconify Window

List Navigation:

  • ↑: Move Selection Up
  • ↓: Move Selection Down

Reminder Management:

  • Space: Toggle Completion
  • Enter: Edit Selected Reminder

Editing:

  • ⌘S: Save Changes

Using the Reference​

When to Check:

  • Learning Vigilare
  • Forgot a shortcut
  • Want to work faster
  • Before giving demo

Print-Friendly:

  • Take screenshot of tab
  • Print for desk reference
  • Share with team members

Feedback Settings​

Send suggestions, bugs, and feature requests.

Feedback Form​

What You Can Report:

  • Bugs: Something not working
  • Features: What you wish Vigilare had
  • Usability: Confusing interface elements
  • Documentation: Unclear or missing docs
  • Performance: Slow or laggy behavior

Form Fields:

Feedback (Required):

  • Text area for your message
  • Minimum 10 characters
  • Be as detailed as possible
  • Include steps to reproduce (for bugs)

Email (Optional):

  • For response from team
  • Leave blank for anonymous feedback
  • Only used for follow-up

How to Submit​

  1. Settings → Feedback tab
  2. Type your feedback (10+ characters)
  3. Optionally add email
  4. Click "Submit Feedback" button
  5. Confirmation message appears
  6. Feedback sent to development team

Writing Good Feedback​

For Bugs:

Good: "When I archive a list in Settings,
the app crashes. Steps: 1) Open Settings,
2) Go to Lists, 3) Toggle off any list,
4) App crashes. macOS 16.1, Vigilare 1.0.2"

Bad: "App crashes sometimes"

For Features:

Good: "Would love to see tags for tasks,
similar to Reminders app. I organize tasks
by context (#work, #home, #urgent) and tags
would help filter. Use case: Show all #urgent
tasks across multiple lists."

Bad: "Add tags"

For Usability:

Good: "The iconify button (⌘E) is not
discoverable. I didn't know about minimize
mode for weeks. Suggest: Add tooltip on
hover, or include in onboarding."

Bad: "Interface confusing"

Response Time​

What to Expect:

  • Feedback goes to development team
  • Not instant customer support
  • Email responses for actionable bugs
  • Feature requests considered for roadmap
  • All feedback reviewed

No Response ≠ Ignored:

  • Team reads all feedback
  • Not all get individual replies
  • Used to prioritize development
  • Your input matters

About Information​

App details and credits.

What's Included​

App Version:

  • Current version number
  • Build number if applicable
  • Useful for bug reports
  • Check if you're up to date

Description:

  • What Vigilare does
  • Brief app summary
  • Developer information

Links:

Privacy Policy:

About Labee LLC:

  • Links to https://labee.jp
  • Developer/company information
  • Other products
  • Contact information

When to Check About​

Bug Reports:

  • Always include version number
  • Helps diagnose issues
  • Different versions may have different bugs

Privacy Questions:

  • Read full privacy policy
  • Understand data handling
  • No surprises

Credits:

  • See who built Vigilare
  • Attribution for open source components
  • Acknowledgments

Settings Persistence​

How your settings are saved.

Automatic Saving​

All Changes Save Immediately:

  • No "Save" or "Apply" button needed
  • Toggle switches save on change
  • Selections save instantly
  • Close Settings window anytime

Where Settings Stored:

  • macOS User Defaults system
  • Local preferences file
  • ~/Library/Preferences/jp.labee.floating-reminders.plist
  • Not synced across devices (by design)

Why Not Synced:

  • Window position is machine-specific
  • Display configurations differ
  • Archived lists are personal preference
  • Each Mac can have different setup

Resetting Settings​

If Needed:

  1. Quit Vigilare completely
  2. Delete preferences file: 
    ~/Library/Preferences/jp.labee.floating-reminders.plist
  3. Restart Vigilare
  4. All settings reset to defaults
  5. Window appears at default position

What Gets Reset:

  • Window position
  • Window level
  • Space display
  • Launch at login
  • Archived lists (all unarchived)

What Doesn't Change:

  • Your actual reminders (safe)
  • Lists in Apple Reminders (safe)
  • iCloud data (safe)

Common Settings Configurations​

Recommended setups for different workflows.

The Fullscreen Worker​

Best for: Developers, writers in fullscreen

Settings:
- Launch at Login: ON
- Window Level: Always on Top
- Space Display: All Spaces
- Lists: Archive non-current projects

Why:
- Tasks visible in fullscreen apps
- Follows between Spaces
- Boots with system
- Only see relevant lists

The Multi-Tasker​

Best for: Project managers, support roles

Settings:
- Launch at Login: ON
- Window Level: Normal
- Space Display: All Spaces
- Lists: Keep most lists active

Why:
- Works with many windows
- Visible but not intrusive
- Easy to bring to front (⌘Tab)
- All projects accessible

The Context Switcher​

Best for: Freelancers, consultants

Settings:
- Launch at Login: ON
- Window Level: Normal
- Space Display: Current Space Only
- Lists: Archive inactive clients

Why:
- Dedicated Spaces per client
- Tasks only where relevant
- Clean separation
- Focus per Space

The Minimalist​

Best for: Occasional users, clean desktop lovers

Settings:
- Launch at Login: OFF
- Window Level: Desktop
- Space Display: Current Space Only
- Lists: Archive most lists

Why:
- Launch when needed
- Never covers work
- Minimal visual presence
- Single-focus approach

Troubleshooting Settings​

Settings Won't Open​

Try:

  1. Click ⚙ button again
  2. Try ⌘, keyboard shortcut
  3. Restart Vigilare if persistent

Changes Not Applying​

Check:

  • Space Display changes require restart
  • Other changes apply immediately
  • Close and reopen window to verify
  • Check if system settings override

Lost Settings​

If Settings Reset:

  • Preferences file may have been deleted
  • macOS update may have reset
  • Restore from Time Machine backup
  • Or reconfigure manually (takes 1 minute)