Gubb Help Center

📝 Notes & Rich Text Editor

Gubb’s powerful editor supports rich text formatting with real-time markdown rendering. Create beautiful, structured documents with ease.

Getting Started

• Create New Note: Click the “+” button in the sidebar
• Switch Notes: Click any note in the sidebar
• Auto-Save: All changes are automatically saved as you type

Text Formatting

Headings & Structure

Lists & Navigation

• Bullet Lists: Type - or * at the beginning of a line
• Numbered Lists: Type 1. at the beginning of a line
• Exit Lists: Press Enter twice on an empty list item
• Links: Use Ctrl/Cmd + K to insert links

🎤 Voice-to-Text

Dictate your thoughts naturally with AI-powered speech recognition. Perfect for quick note capture and hands-free writing.

Setup Requirements

• OpenAI API Key: Bring your own OpenAI API key for premium accuracy
• Microphone Access: Grant permission when prompted
• Internet Connection: Required for AI processing

How to Use

• Start Recording: Click the microphone icon (🎤) in the toolbar
• Speak Clearly: Talk naturally at normal pace
• Stop Recording: Click the microphone icon again
• Auto-Insert: Transcribed text automatically appears in your note

Tips for Best Results

📋 Clipboard History

Never lose copied content again. Gubb automatically tracks your clipboard history, making it easy to access previously copied text, links, and content.

Accessing Clipboard History

• Open Panel: Click the clipboard icon (📋) in the sidebar
• Search History: Type in the search box to filter items

Using Clipboard Items

Supported Content Types

• ✅ Plain text
• ✅ URLs and links
• ✅ Rich text formatting
• ✅ Code snippets
• ✅ Email addresses
• ✅ Phone numbers

⏰ Timer & Pomodoro

Stay focused and productive with built-in Pomodoro timer, countdown timer, and break reminders. Perfect for time management and maintaining work-life balance.

Timer Types

Using the Timer

• Start Timer: Click the timer icon (⏰) in the toolbar
• Choose Type: Select Pomodoro, Break, or Custom duration
• Minimize: Click minimize to keep timer running in background
• Notifications: Get desktop notifications when timer completes

Break Reminders

• Micro Breaks: 20-second eye rest reminders every 20 minutes
• Full-Screen Breaks: Mandatory break screens for extended work sessions
• Customizable Intervals: Set your preferred break frequency
• Skip Option: Skip breaks when in deep focus (not recommended)

✅ To-do Lists & Checklists

Create interactive checklists that help you stay organized and track progress. Perfect for project management, daily tasks, and goal tracking.

Activate Todo using gubb@todo

Creating Checklists

Interactive Features

• Click to Toggle: Click any checkbox to mark complete/incomplete
• Visual Feedback: Completed items show strikethrough text
• Auto-Save: Checkbox states automatically save
• Progress Tracking: Visual indication of completion status

Example Checklist

# Daily Tasks
[ ] Review emails
[ ] Update project status
[x] Complete report
[ ] Schedule team meeting
[x] Call client
Shopping List
[ ] Milk
[ ] Bread
[x] Apples
[ ] Cheese

📊 Kanban Boards

Visualize your workflow with automatic Kanban board detection. Write simple markdown and watch it transform into beautiful, interactive project boards.

Auto-Detection Triggers

• Keyword: gubb@board
• Structure: Multiple headings with task lists underneath
• Format: Traditional column-based layout pattern

Creating a Kanban Board

# Project Kanban Board
To Do
[ ] Design mockups
[ ] Write specifications
[ ] Setup development environment
In Progress
[ ] Build user interface
[ ] Implement authentication
Review
[ ] Code review feature A
[ ] Test new functionality
Done
[x] Project planning
[x] Requirements gathering

Board Features

🎨 Themes & Appearance

Customize Gubb’s appearance to match your style and preferences. Choose from multiple themes, fonts, and layout options for the perfect writing environment.

Accessing Settings

• Open Settings: Click the settings icon (⚙️) in the sidebar
• Quick Theme Toggle: Click the palette icon (🎨) for instant theme cycling
• Font Cycling: Click the font icon to cycle through available fonts

Available Themes

Typography Options

• Font Size: Adjustable from 12px to 24px
• Line Height: Customizable spacing for comfort
• Font Families: Multiple typefaces for different writing styles
• Paper Types: Lined, grid, or plain background options

🔊 Keyboard Sounds

Add satisfying typing sounds to enhance your writing experience. Gubb’s keyboard sounds work system-wide, making every keystroke more enjoyable and tactile.

Setup Requirements (macOS)

• Accessibility Permission: System Preferences → Security & Privacy → Privacy → Accessibility
• Input Monitoring: System Preferences → Security & Privacy → Privacy → Input Monitoring
• Add Gubb: Click the “+” button and select Gubb.app
• Enable Checkbox: Check the box next to Gubb in both sections

Available Sound Profiles

• NK Cream
• EG Oreo
• EG Crystal Purple
• Cherry MX Black ABS
• Cherry MX Black PBT 
• Cherry MX Blue PBT
• Cherry MX Brown ABS
• Cherry MX Brown PBT
• Cherry MX Red ABS
• Cherry MX Red PBT

Configuration Options

• Volume Control: Adjust sound volume from 0-100%
• Global Toggle: Enable/disable system-wide with hotkey

Troubleshooting

• No Sound: Check permissions in System Preferences
• Restart Required: Restart Gubb after granting permissions
• Performance Issues: Lower volume or reduce sound quality

🔍 Search & Navigation

Quickly find and navigate between your notes with powerful search capabilities. Never lose track of your ideas with intelligent search and organization.

Search Methods

Search Features

• Real-time Results: See results as you type
• Highlight Matches: Search terms highlighted in results

Organization Tips

• Descriptive Titles: Use clear, searchable note titles
• Tags in Content: Include relevant keywords in note content
• Date References: Include dates for time-sensitive notes
• Categories: Use headings to categorize information

🧮 Math & Conversions

Perform calculations, currency conversions, and unit measurements directly within your notes. No need to switch apps – get instant results while you work.

Activate maths using gubb@math

Mathematical Expressions

Currency Conversions

Activate currency using gubb@currency

• Real-time Rates: Live exchange rates from financial APIs
• Format: amount FROM to TO
• Examples:

100 USD to EUR
=50 GBP to USD
=1000 JPY to CAD
€500 to $

Unit Conversions

Activate conversions using gubb@conversions

Usage Tips

• Auto-Detection: Calculations appear automatically when you type expressions
• Results Inline: Results appear next to your calculations
• Copy Results: Click results to copy to clipboard
• Precision: Results rounded to appropriate decimal places
• Error Handling: Clear feedback for invalid expressions