Documentation

KeyMood docs

Everything KeyMood can do, and where to find it. Start with Getting started, or search for a feature.

Getting started

Install

KeyMood runs on any Mac with macOS 13 Ventura or later, Apple Silicon or Intel.

  1. Buy KeyMood on this website. Right after checkout you get the download link, and your license key arrives by email.
  2. KeyMood is signed with our Developer ID and notarized by Apple, so it opens normally. No right-click workaround or security setting changes needed.
  3. Open it and drag KeyMood into your Applications folder.
  4. Open KeyMood from Applications or Launchpad. It's signed and notarized by Apple, so it opens without warnings.

KeyMood lives in your menu bar, not the Dock. Look for its icon at the top right of your screen. The first time you open it, a setup guide walks you through activation, permission and your first sound.

Activate your license

KeyMood is a one-time purchase. After checkout, your product key arrives by email from Dodo Payments, our payment provider.

  1. Open KeyMood. The setup guide shows the Activate step.
  2. Paste your product key and press Activate.
  3. When it says KeyMood is activated, press Continue.

Activation needs an internet connection once. After that, KeyMood works offline and checks your license now and then when you're online.

Two Macs per key. Each product key works on up to 2 of your Macs. See License and billing to move KeyMood to a new Mac.

Allow Input Monitoring

macOS asks every app that reacts to key presses for Input Monitoring permission. KeyMood can't play key sounds without it.

  1. In the setup guide, press Open System Settings.
  2. In Privacy & Security → Input Monitoring, turn on KeyMood.
  3. Come back to KeyMood. It notices the permission and continues. If it doesn't, quit and reopen KeyMood.
What KeyMood sees. Only that a key went down or up, and which group it belongs to (letter, space, return and so on). It never records, stores or sends what you type. See Privacy and data.

A quick tour

KeyMood has two places to work from:

  • The menu bar panel for everyday switches: mood, sound pack, volume and quick toggles. Click the menu bar icon or press ⌃⌥⌘P to cycle moods without opening it.
  • The main window for everything else. Its sidebar has these pages:
PageWhat it's for
HomeToday's stats, moods and quick toggles
Sound LibraryAll 31 keyboard packs. Preview any, use it in one tap
Keyboard StudioMap each key group to any pack, with its own volume and pitch
Mouse StudioClick, trackpad and scroll sounds
Ambient StudioNine live soundscapes, your own mixes, and Typing Music
RecordingsRecord typing sessions, or record your own keyboard into a pack
Visual EffectsNotch, typing canvas, click effects, cursor trails, keyboard visualizer
Mac BuddyYour desktop buddy, plus wellness and task reminders
Focus ModePomodoro sessions, garden and aquarium
Typing Games30-second rounds, achievements and daily challenges
StatisticsKeys, WPM, streaks and most-used keys
AutomationSchedules, per-app rules and silent hours
SettingsAppearance, output, shortcuts, license and privacy

Moods

A mood switches several things at once: the accent color, the keyboard pack and the ambience. Tap a mood again to turn it off and go back to your own choices.

The six moods are Focus, Cozy, Gaming, Cyberpunk, Minimal and Retro. Press ⌃⌥⌘P to cycle through them from anywhere.

With Mood wallpapers turned on (Visual Effects), Retro draws CRT scanlines and Cyberpunk a neon grid on your desktop.

Keyboard sounds

KeyMood comes with 31 keyboard packs in these categories: Recorded, Clicky, Linear, Tactile, Soft, Silent, Vintage, Retro, Fun and Futuristic. Hear every one of them in the Sound lab.

Open Sound Library to preview a pack and press Use to switch to it. Each pack has separate sounds for letters, space, return, delete and modifier keys, with several recordings of each so repeated presses don't sound robotic.

Options (Settings)

  • Release sounds: a softer sound when a key comes back up.
  • Play on key repeat: holding a key down keeps clicking.
  • Low-latency mode: a 128-frame audio buffer (about 2.7 ms) for the fastest response.

External keyboards

Turn on Keyboard profiles and KeyMood switches sounds automatically depending on which keyboard you type on: built-in, USB or Bluetooth. Each keyboard can have its own pack and volume.

Keyboard Studio

Keyboard Studio lets you build your own profile by mapping each key group to any pack, with its own volume and pitch. The groups are letters, space, return, backspace, delete, shift, command, option, control and fn.

  • New, Duplicate, Delete: manage profiles. Preview profile plays a short phrase.
  • Randomizer: Variant per press, No immediate repeat, Shuffle within category, Release sounds, Stereo by key position, Stereo width and Randomness.
  • Equalizer: Bass, Mid, Treble and Master pitch, with a Reset button.
  • Share profiles: Export a profile as JSON, or paste one to Import it.

Mouse, trackpad and scroll

Open Mouse Studio. Left, right and middle buttons each sound different. There are 8 click styles (the default, Street Click, is a real recorded mouse) and 7 scroll styles.

SettingWhat it does
Click volume, Release soundsHow loud clicks are, and whether releasing the button makes a sound
Double-click accentDouble-clicks sound slightly different
Distinct right clickRight clicks get their own sound
Movement swishA soft swish on very fast mouse flicks
Gesture feedbackSounds for trackpad swipes, pinches and rotations
Trackpad has its own soundsTrackpad clicks use their own sounds; an external mouse keeps the click style
Scroll sounds, Scroll volumeOne tick per wheel notch. Fast flicks play lighter
Trackpad always uses SwishTrackpad scrolling plays Trackpad Swish; mouse wheels keep your scroll style

Ambient soundscapes

Open Ambient Studio. There are nine soundscapes: Rain, Fireplace, Coffee shop, Forest, Ocean, Wind, Night, Thunderstorm and Library. They're generated live on your Mac, so they never loop.

  • Turn on several at once and set each one's level to make your own mix.
  • Mixes are saved presets. Choosing one also switches the keyboard pack.
  • Master sets the overall level. Typing ↔ Ambient balances key sounds against the ambience.
  • Random variation varies the timing of raindrops, crackles and birds.

Typing Music

Typing Music turns your typing into music. Every key plays a note on a scale, over an optional drone and a beat that follows your speed. Turn it on in Ambient Studio → Typing Music, with the Music tile in the menu bar panel, or from the Home page.

OptionChoices
Scale (21)Raga Bilawal, Yaman, Bhairav, Bhupali, Kafi and Malkauns; Chinese pentatonic, Japanese In, Japanese Hirajoshi, Balinese Pelog; Arabic Hijaz, Hungarian minor; Major, Minor, Harmonic minor, Lydian, Dorian, Celtic (Mixolydian), Whole-tone; Blues, Minor pentatonic
Instrument (13)Soft piano, Marimba, Glass bell, Warm pad, Pluck, Sitar, Santoor, Bansuri flute, Kalimba, Koto, Oud, Steel pan, Harp
Rhythm (7)Off, Tabla, Lo-fi drums, Electronic, Bossa nova, Hip-hop, Reggaeton
  • Tanpura drone: a continuous Pa – Sa – Sa – Sa drone underneath, tuned to your notes.
  • Tempo follows my typing: type faster and the beat speeds up, from 72 to 140 BPM. Or set a fixed Tempo.
  • Intensity and Music volume control how present the music is.
  • Keep key clicks: play your keyboard sound under the music.

Import and record sounds

Import sounds

Turn your own audio into mappable sounds. KeyMood accepts WAV, MP3, M4A, AIFF and CAF files. You can also import Mechvibes packs (a folder, a .zip or its JSON file), and they keep their per-key sounds.

Record your own keyboard

On the Recordings page, the Keyboard recorder uses your Mac's microphone to record your real keyboard. KeyMood splits the recording into keystrokes and builds a sound pack you can use anywhere.

  1. Press Record and allow microphone access if macOS asks.
  2. Type slowly and evenly for 15–30 seconds, about 20 cm from the mic.
  3. Name the pack and save it.

The microphone is used only while you record a pack, never at any other time.

Visuals

Dynamic notch

A live visualizer that hugs the camera notch and pulses as you type. On Macs without a notch, it drops down from the menu bar like one. Toggle it with ⌃⌥⌘V.

  • Style: Bars, Wave or Dots. Theme: Classic, Neon, Sunset or Mono.
  • Material: Solid, Transparent, Frosted, Liquid Glass or Outline, with an Opacity slider.
  • Text messages: off shows only the visualizer; on also shows mood, focus and achievement messages.

Typing canvas

The Live typing canvas draws effects that bloom from where each key sits, on the display under your pointer. Clicks always pass straight through it.

There are 19 effects: Ripples, Glow, Particles, Neon waves, Falling letters, Galaxy, Fire, Code, Fireworks, Lightning, Hearts, Bubbles, Snow, Matrix rain, Starburst, Confetti, Comets, Pixel blast and Sakura. Falling letters and Code drop the exact key you pressed. Falling letters has three letter styles: Classic (big rounded letters), Developer (a small code-editor font in VS Code colours) and Hacker (glowing green dot-matrix letters).

  • Draw over windows: on draws above every app, including full screen; off draws on the desktop only.
  • Intensity and Speed tune the effect. Colors follow your mood, or pick your own.

Click effects and cursor trails

Click effects bloom at the pointer on every mouse click, over any app and on any display. Styles: Water, Burst, Ink, Pulse, Sparkle, Bubbles, Confetti and Neon. Set the Size, and turn on Right-click in accent colour to tell left and right clicks apart.

A Cursor trail follows your pointer as you move it. Styles: Ribbon, Orbs, Comet, Neon and Stardust, with Length and Thickness sliders.

Keyboard visualizer

A floating on-screen keyboard that mirrors your presses. Toggle it with ⌃⌥⌘K. Choose a Full, 75% or 60% layout, and turn on Usage heatmap to color keys by how often you've pressed them today.

Themes

In Settings → Appearance, pick one of 11 themes: System (follows macOS light and dark), Light, Dark, Liquid Glass (a monochrome glass look like macOS notifications), Graphite, Ocean, Forest, Nord, Rose, Sand and Lavender.

The theme sets the colors of KeyMood's windows. Moods set the colors of effects.

Companion

Mac Buddy

A small friend on your desktop that hops when you type fast, naps when you stop and celebrates your wins. Pick a cat, dog, penguin, duck, robot, ghost or Pixel Pal, give it a name and, for some, a color.

  • Show: drag it anywhere. Click to pat it. KeyMood counts your pats.
  • Size and Always on top.
  • Walking mode: when you leave the Mac alone, your buddy walks around the screen (ghosts float), then naps. It stops when you use the mouse or keyboard.
  • Celebrations: every 100 keys, your daily goal, focus sessions, records and unlocks.
  • Accessories: unlock a Party hat, Shades, Scarf, Headphones and Crown by using KeyMood. They're never sold.
  • Voice: your buddy can say reminders out loud in its own voice, using your Mac's built-in voices, fully offline. Critter call first plays a meow, woof, quack or beep-boop before it speaks (also when you pat it). Adjust Voice volume.

Wellness reminders

Your buddy reminds you to look after yourself. Reminders count active screen time, and stepping away for 5 minutes or more counts as a break. When a reminder appears, you can snooze it for 10 minutes.

ReminderDefault
Drink waterEvery 45 minutes, with a goal of 8 glasses a day
Rest your eyesEvery 20 minutes
StretchEvery 50 minutes
Screen-time restAfter 90 minutes of screen time
MealsBreakfast 9:00, lunch 13:30, dinner 20:30
Sleep23:30

You can change every interval and time, edit each reminder's title and message, and add your own repeating reminders (for example "Posture check" every 30 minutes). Reminder sounds plays a soft chime for each; Silent mode mutes them.

Task reminders

Add your own reminders on the Mac Buddy page under Your reminders. Each one has a title, an icon, an optional message your buddy says out loud, and a repeat:

  • Once at a date and time
  • Daily at a time
  • Weekly on the days you choose
  • Every so many minutes

When a reminder is due, KeyMood shows a card, says it out loud and plays a chime. Your buddy walks over to deliver it, even if you've hidden the buddy.

Productivity

Focus mode

Pomodoro sessions built in. Start one from the menu bar panel, the Focus Mode page, or with ⌃⌥⌘F. While you focus, the menu bar shows the time left.

  • Lengths: focus 25 minutes, short break 5, long break 15 by default. The daily goal is 4 sessions.
  • Session settings: a focus session can switch to a chosen sound profile and ambience, then restore yours afterwards. Auto-start breaks starts the break for you.
  • Productivity Garden: each focus session plants a seed, and each break you take helps one grow. Nothing ever wilts.
  • Typing Aquarium: one fish for every completed session.
  • Session history: your sessions and focused minutes this week.

Typing games and achievements

Typing Games: 30 seconds, as many words as you can. Every key still plays your sound. You get WPM, accuracy and points, and a New record badge when you beat your personal best.

Daily challenges: type 1,000 keys, finish a focus session and reach 40 WPM.

Achievements:

AchievementHow to unlock
First StepsType 100 keys
Warmed Up1,000 keys in one day
Marathon10,000 keys all-time
Speed DemonHit 60 live WPM
In the ZoneFinish a focus session
Deep Work4 focus sessions in a day
Game OnFinish a typing game
Sharpshooter95% accuracy in a game
Night OwlType after midnight
On a Roll3-day typing streak

Statistics

The Statistics page shows counts and timings only, stored on your Mac: Today, This week, Last 30 days with your day streak and daily key goal, Most-used keys today and Personal bests.

Turn off Collect statistics in Settings and nothing is counted at all.

Session recorder

On the Recordings page, the session recorder captures your typing session as an audio clip: clicks, music, beats and ambience. It records KeyMood's own sound only, never the microphone or your text.

Clips are saved as .m4a files on your Mac. Play them back from the Recordings page, or show them in Finder to share them.

Control

Automation

Let KeyMood switch sounds for you on the Automation page.

  • Sound scheduler: switch profiles by time of day. The active rule is marked Active.
  • App-specific profiles: switch to a profile, or mute, in particular apps. Press Add app… and pick the app.
  • Keyboard profiles: switch by keyboard (built-in, USB or Bluetooth). See Keyboard sounds.

Which rule wins

When several rules apply, KeyMood uses the first match in this order:

  1. App rule
  2. Keyboard rule
  3. Focus session
  4. Scheduler
  5. Mood
  6. Your selected pack

Silent hours and muting

  • Mute everything: the switch in the menu bar panel, or ⌃⌥⌘M.
  • Silent mode: ⌃⌥⌘S, or the Silent tile.
  • Silent hours: set a time range (From and To). It silences key, mouse and system sounds and pauses nothing else. Override tonight skips it for one night.
  • Mute on built-in speakers: only play through headphones or external speakers.
  • Per app: mute in specific apps with App-specific profiles.

The menu bar panel always tells you why KeyMood is quiet: Sounds off, Silent mode, Silent hours, Muted in an app (for example "Muted in Zoom") or Muted on speakers.

Sound output and event sounds

  • Output: choose which device KeyMood plays through, separately from your Mac's default.
  • Master volume sets the overall level.
  • Event sounds: pick a sound, or none, for each KeyMood event: Sound profile switched, Mood changed, Focus session starts, Focus session complete, Break is over, Achievement unlocked, KeyMood window opens and closes, Window minimised and Window restored. Turn them all off with Play KeyMood event sounds.

macOS's own system sounds can't be replaced by apps.

Keyboard shortcuts

These work from any app.

ShortcutAction
⌃⌥⌘MTurn sounds on or off
⌃⌥⌘PCycle through moods
⌃⌥⌘SSilent mode on or off
⌃⌥⌘VShow or hide the notch visualizer
⌃⌥⌘FStart or stop a focus session
⌃⌥⌘KShow or hide the keyboard visualizer

General settings

  • Launch at login: start KeyMood when you log in.
  • Show in Dock: KeyMood normally lives only in the menu bar.
  • Updates: check for a new version, or turn on Check automatically once a week (off by default).
  • Accessibility: every control has VoiceOver labels, works with the keyboard, and respects Reduce Motion.
Account and help

License and billing

  • One-time purchase of $7.99. No subscription. Taxes are calculated at checkout by Dodo Payments.
  • 2 Macs per key. To move KeyMood to a new Mac, open Settings → License on the old Mac and press Deactivate this Mac, then activate the new one.
  • Lost your key? Search your email for the Dodo Payments receipt, or contact us with your order email.
  • Refunds: see the refund policy.

Privacy and data

  • No keylogging. Each key press maps to a sound group and a counter. KeyMood never records, stores or sends what you type.
  • Local only. Settings, statistics, reminders and recordings stay on your Mac. There's no account and no cloud.
  • No analytics, no ads, no tracking.
  • Network. KeyMood contacts Dodo Payments only to activate and check your license, using your key and an anonymous device label. If you turn on update checks, it also fetches the latest version number.
  • Microphone. Used only while you record a keyboard pack.

Read the full privacy policy.

Troubleshooting

I don't hear any key sounds
  1. Check the top of the menu bar panel. It says why KeyMood is quiet (for example Silent hours, Muted in an app, or Not activated).
  2. Make sure Input Monitoring is on for KeyMood in System Settings → Privacy & Security. If it is, quit and reopen KeyMood.
  3. Press ⌃⌥⌘M in case sounds were turned off.
  4. If Mute on built-in speakers is on, plug in headphones or turn it off.
  5. In Settings → Output, check KeyMood is playing through the device you're listening to.
It asks for permission again every time I open it

macOS keeps one Input Monitoring permission per app, tied to the copy you allowed. A second copy of KeyMood makes the two cancel each other out.

  1. Make sure you open KeyMood from your Applications folder, not from the downloaded DMG. Eject the KeyMood DMG once it's installed.
  2. Move any other copies of KeyMood (for example in Downloads) to the Bin. KeyMood 1.0.2 and later point out the extra copy for you with a Show the other copy button.
  3. In System Settings → Privacy & Security → Input Monitoring, select KeyMood and remove it with −, then turn it on again from KeyMood.

After that, the permission stays put when you quit and reopen KeyMood, and when you update it.

It says "Not activated"

Open KeyMood's main window, go to Settings → License and paste your product key. Activation needs an internet connection once. If the key is already used on 2 Macs, deactivate one of them first.

The sound feels slightly late

Turn on Low-latency mode in Settings. Bluetooth headphones add their own delay; wired headphones or speakers respond fastest.

I can't see the notch visualizer or my buddy

Turn on the Notch or Buddy tile in the menu bar panel. For the buddy, also check Show on the Mac Buddy page.

Effects cover my work

Clicks always pass through effects. To keep them off your windows entirely, turn off Draw over windows so they appear on the desktop only, or lower the Intensity.

KeyMood is quiet in one app

Check Automation → App-specific profiles. That app may be set to mute.

Get help

Still stuck? Contact us and tell us your macOS version and what you see in the menu bar panel. You can also browse the FAQ.