September
September is an assistive communication app for people with ALS, MND, or other speech and motor difficulties. It helps a user express a full thought with fewer keystrokes.
The screenshots on this page show the browser app with sample data.
Applications
September contains three applications:
apps/web is the browser application.apps/desktop is the Tauri application for macOS.apps/keyboard is the native floating keyboard for macOS.
The web and desktop applications import the same rules, autocomplete engine,
design system, and application screens from the root workspace packages. Each
app keeps its own route bootstrap and platform services. The web app also has a
public landing page at /.
The web app stores data and its bounded speech cache in one IndexedDB database. The desktop app stores domain data in SQLite and provider keys in the macOS Keychain.
Features
- Talk spaces combine saved phrases, word suggestions, and a text composer.
- Setup asks how the person chooses things: touch, a mouse, a keyboard, a
switch, or eye gaze. Every key is 48px or more. Eye gaze presses a key after a
dwell, and switch scanning steps through the groups of keys.
- A suggestion row can start with the typed words or contain them. The Mac app shows Talk in one panel that floats above other apps.
- A note is a Markdown document. The writing tools and the Talk suggestions open at the caret, and a list of notes sits beside the page.
- Each space has an Agent that can read its context and propose approved
changes to its setup, notes, phrases, and Talk transcript.
- System and ElevenLabs voices speak Talk messages and notes.
- The ElevenLabs Dialogue voice reads audio tags such as
[laughs]. Five mood keys set the tone of the suggestions.
- Notes store prepared long-form text inside a space.
- A note presents full-screen in the user's voice, and exports as text, audio, or a captioned video.
- Phrase codes expand short input into a full phrase.
- Local usage reports show saved keystrokes and provider use.
- AI Assistance uses one provider. Suggestions have their own model. The agent and phrases share a second model.
- Separate switches control automatic AI suggestions, phrase generation, and the agent. AI suggestions wait for a space or punctuation.
- A portable JSON backup moves settings and data between the browser and Mac apps.
- ElevenLabs can create a cloned voice from browser or desktop recordings.
- Help groups step-by-step guidance by task, searches the shared guide catalog,
and labels each guide for the browser, Mac app, or Mac keyboard.
Help remains available before setup is complete. The setup screen opens its
guide inline, while /help and each stable guide link open the full Help
screen.
Screens
A note holds prepared long-form text inside a space. The same words read aloud,
present, or export.
Present fills the screen with one chunk of the note at a time and speaks it in
the user's voice.
Today reports the typing the app saved and what the services cost. The numbers
stay on the device.
Requirements
- Node.js 20 or later
- pnpm
- Rust and the Tauri system requirements for desktop builds
- Swift 6 and Xcode command-line tools for the native keyboard
Install
Install the JavaScript workspace from the repository root:
pnpm install
The web app does not use environment variables for provider keys. Add OpenRouter or ElevenLabs keys in the application settings.
Develop
Check every package from the repository root:
pnpm build
pnpm lint
pnpm test
The packages share one configuration. tsconfig.base.json holds the compiler
options, eslint.config.mjs holds the lint rules, vite.shared.ts holds the
Vite and Vitest pieces, and vitest.setup.ts gives jsdom what React tests need.
Start the browser application:
make dev
The application opens at http://localhost:3009.
Start the desktop application:
make desktop-dev
Start the native keyboard:
make mac-run
Build its signed app bundle or installable DMG:
make mac-app
make keyboard-dmg
The keyboard uses the bundle identifier com.september.keyboard. The DMG is
written to apps/keyboard/.build/release/Keyboard.dmg.
Release the desktop app
Store the Apple signing values in the ignored root .envrc file:
export APPLE_TEAM_ID=...
export APPLE_SIGNING_IDENTITY=...
export APPLE_PROVISIONING_PROFILE=...
export APPLE_API_ISSUER=...
export APPLE_API_KEY=...
export APPLE_API_KEY_PATH=...
Create the signed desktop installer from the repository root:
make desktop-release
The command builds the app and DMG, submits both to Apple, staples the tickets,
checks the DMG with Gatekeeper, and prints its path and SHA-256 checksum.
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
