Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[BUG] Can't add new words to custom dictionary

Closed
  • Is something wrong?
#1,165 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
45/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
macos, swift
Domain
accessibility, desktop

Research direction

Start from the custom dictionary and Custom Words (Advanced) screens, then trace how words are saved and passed to speech recognition. Reproduce with “posthog” and check whether a saved word appears in the library and changes recognition from “post hoc”; clarify the distinction between the two word lists in the interface.

Written by the indexing model from the issue text.

Description

bug
Describe the bug

In the custom dictionary it always says "These recordings contain everyday words" for pretty much any word I want to add. E.g. adding "posthog" (because it recognizes it as "post hoc" won't work.

Also I couldn't find how to add new words manually. Not just are the dictionary words hidden in a sidebar I separately have to open, there's no way to add new words anywhere (or I couldn't find it at least). Adding it to the "Custom Words (Advanced)" works, but they don't appear in the library. Furthermore configuring advanced words still doesn't help with recognition - it keeps spelling "post hoc".

Reproduction steps

Speak "posthog" and see the recognition error. Try adding a new word in the Custom Dictionary and see the "everyday" message appear. Try to add it to custom words (advanced) and find no improvement in recognition.

Expected behavior

The Custom Words functionality is great, but it should accept my edits - an easier way to find the library of custom words would be great and some explanation what the difference between the custom words and custom dictionary is (if there's even any difference).

Actual behavior

As described.

App Version

1.6.11

macOS Version

macos 26.6.2

Architecture

Apple Silicon

Logs or crash report
Screenshots or screen recording

No response

Dominant language
Swift
Stars
11.9k
Forks
863
Avg merge
1d 8h
Merged PRs (30d)
37

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from altic-dev/FluidVoice

All issues in altic-dev/FluidVoice

Similar issues

More Swift issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.