Welcome to the Gubb Help Center. This comprehensive guide covers everything you need to know about using Gubb’s powerful productivity features on both Windows and macOS. Get started with our step-by-step tutorials and become a Gubb power user.

๐Ÿ“ 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

FormatKeyboard ShortcutMarkdown Syntax
BoldCtrl/Cmd + Btext
ItalicCtrl/Cmd + Itext
CodeCtrl/Cmd + text
HighlightCtrl/Cmd + H
UnderlineCtrl/Cmd + U
StrikethroughCtrl/Cmd + D~~text~~

Headings & Structure

HeadingKeyboard ShortcutMarkdown Syntax
H1 (Largest)# Heading
H2## Heading
H3### Heading
Code Block``

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

DoDon’t
Speak in complete sentencesRush through words
Use proper pronunciationMumble or whisper
Pause briefly between sentencesRecord in noisy environments
Position mic 6-12 inches awayHold device too close/far

๐Ÿ“‹ 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

ActionHow To
Paste to Current NoteClick any clipboard item
Copy to System ClipboardRight-click โ†’ “Copy to Clipboard”
Delete ItemRight-click โ†’ “Delete”
Clear All HistoryClick “Clear All” button

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

Timer TypeDefault DurationBest For
Pomodoro25 minutesFocused work sessions
Short Break5 minutesQuick rest between tasks
Long Break15-30 minutesExtended rest periods
Custom TimerUser definedSpecific time requirements

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

SyntaxResultNotes
[ ] Taskโ˜ Unchecked itemReady to be completed
[x] Taskโ˜‘ Checked itemMarked as completed
Click checkboxToggle stateInteractive clicking

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

FeatureDescription
Visual ColumnsAutomatic column layout based on headings
Task CardsEach list item becomes a draggable card
Progress TrackingVisual progress indicators per column
InteractiveClick checkboxes to mark tasks complete

๐ŸŽจ 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

ThemeBest ForKey Features
Light ModeDaytime writingHigh contrast, easy on eyes
Dark ModeNight sessionsReduced eye strain, battery saving
Forest ThemeNature loversGreen tones, calming atmosphere
Ocean ThemeFocus sessionsBlue tones, serene feeling

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 TypeHow to AccessSearches
Title Bar SearchClick search icon (๐Ÿ”) in title barNote titles and content
Sidebar SearchSearch box in notes history panelNote titles only
Quick FindCtrl/Cmd + FCurrent note content

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

OperationSyntaxExample
Basic Mathexpression = result25 + 17 = 59
Percentages
Square Root
Powers

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

CategorySupported UnitsExample
Lengthmm, cm, m, km, in, ft, yard, mile5 feet to meters =
Weightg, kg, lb, oz, ton150 lbs to kg =
TemperatureยฐC, ยฐF, K32ยฐF to ยฐC =
Volumeml, l, cup, pint, quart, gallon2 gallons to liters =

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

๐Ÿš€ Quick Start Guide

New to Gubb? Follow these steps to get started in minutes:

  1. Install & Launch: Download from gubb.net and open the app
  2. Create Your First Note: Click the “+” button
  3. Start Writing: Begin typing immediately โ€“ your work auto-saves
  4. Try Formatting: Use bold or italic to see markdown in action
  5. Set Up Timer: Click the timer icon for your first Pomodoro session
  6. Customize Appearance: Click the palette icon to find your perfect theme

๐Ÿ’ก Need More Help?

Can’t find what you’re looking for? We’re here to help:

  • Contact Support: Visit gubb.net/contact for direct assistance
  • Community: Join our Facebook community for tips and discussions
  • Feature Requests: Share your ideas for future updates
  • Bug Reports: Help us improve by reporting any issues

Remember: Gubb is designed to be intuitive. Most features work exactly as you’d expect them to. When in doubt, just try it โ€“ you can’t break anything, and everything auto-saves!