morvox 1.0.0__tar.gz

morvox-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 morhook
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

morvox-1.0.0/PKG-INFO

@@ -0,0 +1,236 @@
+Metadata-Version: 2.4
+Name: morvox
+Version: 1.0.0
+Summary: Offline push-to-talk voice-to-text CLI powered by whisper.cpp
+Author-email: morhook <cruz.fernandez@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/morhook/morvox
+Project-URL: Repository, https://github.com/morhook/morvox
+Project-URL: Issues, https://github.com/morhook/morvox/issues
+Keywords: cli,dictation,speech-to-text,voice,whisper.cpp
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Natural Language :: English
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows :: Windows 11
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Sound/Audio :: Capture/Recording
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# morvox
+
+An awesome push-to-talk-style voice-to-text widget for everyone.
+
+One command (`morvox`) that toggles:
+
+1. **First press** → starts recording from the default mic, remembers the
+   currently focused window/app, and shows a "Recording…" widget.
+2. **Second press** → stops the recorder, transcribes the clip with
+   `whisper-cli` (whisper.cpp), and types the transcription into your
+   target app.
+
+> **Note:** Windows 11 has a built-in dictation tool — press `Win+H` to open it. macOS has System Dictation built in too, accessible via **System Settings → Keyboard → Dictation** (typically triggered by double-pressing `Fn`). morvox is an alternative: it runs a local [whisper.cpp](https://github.com/ggerganov/whisper.cpp) model entirely offline, gives you a visual VU-meter widget, and wires into any hotkey manager you already use.
+
+morvox auto-selects a platform backend:
+
+- **Linux** — uses `parecord` for capture and `xdotool` for window
+  control + keystroke injection. We also support wayland. 
+- **macOS** — uses `ffmpeg` (avfoundation) for capture and `osascript`
+  (System Events) for window focus + keystrokes.
+- **Windows 11** — uses `ffmpeg` (WASAPI) for capture and Win32 APIs for
+  keystroke injection. On Windows, morvox inserts into the window that is
+  focused when transcription finishes: it tries several automatic clipboard
+  paste methods first, then direct Unicode typing, and only leaves the
+  transcript on the clipboard if all insertion methods are blocked.
+
+You can force a backend with `MORVOX_BACKEND=x11`, `MORVOX_BACKEND=macos`,
+or `MORVOX_BACKEND=windows`.
+
+## Table of Contents
+
+- [Epistemology](#epistemology)
+- [Screenshots](#screenshots)
+- [What it does](#what-it-does)
+- [Setup & installation](https://github.com/morhook/morvox/blob/main/INSTALLATION.md)
+  - [Dependencies](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#dependencies)
+  - [Installation](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#installation)
+  - [Hotkey configuration](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#hotkey-configuration)
+    - [Linux hotkey (i3)](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#linux-hotkey-i3)
+    - [macOS hotkey](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#macos-hotkey)
+      - [skhd](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#skhd)
+      - [Hammerspoon](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#hammerspoon)
+    - [Windows hotkey](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#windows-hotkey)
+- [Usage](#usage)
+- [The widget](#the-widget)
+- [Troubleshooting](#troubleshooting)
+- [License](#license)
+
+## Epistemology
+
+The name is based on morhook and voice. mor-vox. I know, if I explain the joke, it's not funny. Don't judge me.
+
+## Screenshots
+
+![capturing on a terminal](https://raw.githubusercontent.com/morhook/morvox/main/screenshot-terminal.png)
+![capturing on vscode](https://raw.githubusercontent.com/morhook/morvox/main/screenshot-vscode.png)
+![capturing on opencode](https://raw.githubusercontent.com/morhook/morvox/main/screenshot-opencode.png)
+![morvox recording inside opencode](https://raw.githubusercontent.com/morhook/morvox/main/screenshot-opencode-chicago-95-xfce.png)
+
+## What it does
+
+- It wraps whisper-cli and shows a VU meter on the user interface. You need to add the hotkey configuration on your OS/Desktop Environment.
+
+## Setup & installation
+
+Setup, dependencies, install steps, and hotkey configuration are in
+[`INSTALLATION.md`](https://github.com/morhook/morvox/blob/main/INSTALLATION.md).
+
+## Usage
+
+```sh
+# toggle (start, then stop+transcribe+type)
+morvox
+
+# fallback if you prefer module execution
+python -m morvox
+
+# status (for i3blocks / polybar)
+morvox --status        # prints "recording" or "idle"
+
+# abort an in-flight recording without transcribing
+morvox --cancel
+
+# keep the wav/txt around for debugging
+morvox --keep-temp
+
+# use a different model / source / typing speed
+morvox --model /path/to/ggml-tiny.en.bin
+morvox --source alsa_input.usb-Maono_Maonocaster…
+morvox --threads 8
+morvox --type-delay 5
+
+# disable the floating widget (headless / SSH / debugging)
+morvox --no-widget
+```
+
+From a source checkout, you can still run `./morvox` before installing.
+
+State files live in `$XDG_RUNTIME_DIR/morvox/` on Linux, falling back to
+`/tmp/morvox-$UID/` when `$XDG_RUNTIME_DIR` is unset;
+`~/Library/Caches/morvox/` on macOS; and `%LOCALAPPDATA%\morvox\` on
+Windows. Override with the `MORVOX_STATE_DIR` env var:
+
+- `rec.pid` — recorder PID
+- `target_window` — saved focused window id
+- `rec.wav` / `rec.txt` — audio + transcript
+- `parecord.log` / `whisper.log` — diagnostic logs
+
+By default these are deleted after a successful type. Pass `--keep-temp`
+to keep them.
+
+## The widget
+
+While recording, morvox shows a small borderless window centred near the
+bottom of the screen. It contains:
+
+- a pulsing red dot (recording indicator),
+- a live VU meter that reacts to your microphone level,
+- an elapsed-time counter.
+
+When you stop recording, the meter is replaced by a "Transcribing…"
+spinner that stays visible until whisper finishes and the transcript has
+been typed. If whisper produced only silence the widget briefly shows
+"No speech detected" instead.
+
+The widget is a self-spawned subprocess of `morvox` (uses Python's
+stdlib `tkinter`). Its stderr is written to the platform state dir's
+`widget.log` for debugging. On Linux/X11 it uses
+`_NET_WM_WINDOW_TYPE_DOCK` so i3 won't try to tile it. On Wayland-only
+sessions without XWayland, or on hosts without `$DISPLAY`, the widget is
+skipped silently.
+
+To disable the widget entirely (e.g. on a headless machine or over SSH),
+pass `--no-widget`.
+
+## Troubleshooting
+
+- **No audio recorded / empty wav (Linux)**
+  Check the active sources: `pactl list short sources`. Pass an explicit
+  source with `--source <NAME>`. Inspect
+  `$XDG_RUNTIME_DIR/morvox/parecord.log` or `/tmp/morvox-$UID/parecord.log`.
+
+- **No audio recorded / empty wav (macOS)**
+  List devices with `ffmpeg -f avfoundation -list_devices true -i ""`
+  and pass an explicit `--source :<idx>`. Inspect
+  `~/Library/Caches/morvox/parecord.log`. If ffmpeg complains about
+  permissions, grant the terminal Microphone access.
+
+- **No audio recorded / empty wav (Windows)**
+  List audio devices with `ffmpeg -list_devices true -f wasapi -i dummy`
+  (or `ffmpeg -list_devices true -f dshow -i dummy` if your ffmpeg build
+  lacks WASAPI) and pass an explicit `--source "<device name>"`. Inspect
+  `%LOCALAPPDATA%\morvox\parecord.log`. If ffmpeg cannot access the
+  microphone, check **Settings -> Privacy & security -> Microphone**.
+
+- **Text typed into wrong window**
+  On Linux and macOS, the originally focused window/app may have been
+  destroyed before you stopped recording. morvox falls back to typing
+  into whatever is currently focused and prints a warning to stderr. On
+  Windows, morvox intentionally types into the window that is focused
+  when transcription finishes.
+
+- **Linux Wayland: nothing is typed (GNOME/Ubuntu)**
+  GNOME/Mutter doesn't implement the `wtype` keyboard protocol and
+  `xdotool` is a no-op against native Wayland windows. Either set up
+  `ydotoold` (`sudo systemctl enable --now ydotoold` and add your user
+  to the `input` group), or install `wl-clipboard` so the transcript
+  lands on your clipboard for manual Ctrl+Shift+V. See
+  [`INSTALLATION.md` (Linux / Wayland)](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#linux--wayland).
+
+- **Linux: widget never appears (asdf/pyenv/conda Python)**
+  The widget runs as a Python subprocess and needs `tkinter`. Many
+  third-party Python builds ship without it. Check
+  `$XDG_RUNTIME_DIR/morvox/widget.log` or `/tmp/morvox-$UID/widget.log` for
+  `No module named 'tkinter'`. Install `python3-tk` and run morvox under the
+  system Python, rebuild your managed Python with Tk support, or use
+  `--no-widget` to silence the warning.
+
+- **macOS: keystrokes silently do nothing**
+  Accessibility permission isn't granted. **System Settings → Privacy &
+  Security → Accessibility** → enable your terminal app.
+
+- **Windows: text does not type into an elevated app**
+  Windows blocks lower-integrity processes from injecting keystrokes into
+  elevated/admin windows. Run morvox from an elevated terminal too, or type
+  into a non-elevated app.
+
+- **Windows: transcript only appears on the clipboard**
+  On Windows 11, morvox first tries several automatic paste methods into the
+  currently focused window and then falls back to direct typing. If all of
+  those are blocked by the app or OS policy, morvox leaves the transcript on
+  the clipboard so you can paste it manually. Inspect
+  `%LOCALAPPDATA%\morvox\whisper.log` for a `windows-insert:` trace showing
+  which insertion path ran and what failed.
+
+- **Whisper too slow**
+  Use a smaller model — `ggml-tiny.en.bin` is roughly 5× faster than
+  `base.en` with a small accuracy hit. Increase `--threads` up to your
+  physical core count.
+
+- **Nothing is typed and notification says "Empty recording"**
+  Whisper produced only a noise token (e.g. `[BLANK_AUDIO]`). Speak
+  closer to the mic or check input gain.
+
+## License
+
+MIT — see [LICENSE](https://github.com/morhook/morvox/blob/main/LICENSE).

morvox-1.0.0/README.md

@@ -0,0 +1,207 @@
+# morvox
+
+An awesome push-to-talk-style voice-to-text widget for everyone.
+
+One command (`morvox`) that toggles:
+
+1. **First press** → starts recording from the default mic, remembers the
+   currently focused window/app, and shows a "Recording…" widget.
+2. **Second press** → stops the recorder, transcribes the clip with
+   `whisper-cli` (whisper.cpp), and types the transcription into your
+   target app.
+
+> **Note:** Windows 11 has a built-in dictation tool — press `Win+H` to open it. macOS has System Dictation built in too, accessible via **System Settings → Keyboard → Dictation** (typically triggered by double-pressing `Fn`). morvox is an alternative: it runs a local [whisper.cpp](https://github.com/ggerganov/whisper.cpp) model entirely offline, gives you a visual VU-meter widget, and wires into any hotkey manager you already use.
+
+morvox auto-selects a platform backend:
+
+- **Linux** — uses `parecord` for capture and `xdotool` for window
+  control + keystroke injection. We also support wayland. 
+- **macOS** — uses `ffmpeg` (avfoundation) for capture and `osascript`
+  (System Events) for window focus + keystrokes.
+- **Windows 11** — uses `ffmpeg` (WASAPI) for capture and Win32 APIs for
+  keystroke injection. On Windows, morvox inserts into the window that is
+  focused when transcription finishes: it tries several automatic clipboard
+  paste methods first, then direct Unicode typing, and only leaves the
+  transcript on the clipboard if all insertion methods are blocked.
+
+You can force a backend with `MORVOX_BACKEND=x11`, `MORVOX_BACKEND=macos`,
+or `MORVOX_BACKEND=windows`.
+
+## Table of Contents
+
+- [Epistemology](#epistemology)
+- [Screenshots](#screenshots)
+- [What it does](#what-it-does)
+- [Setup & installation](https://github.com/morhook/morvox/blob/main/INSTALLATION.md)
+  - [Dependencies](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#dependencies)
+  - [Installation](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#installation)
+  - [Hotkey configuration](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#hotkey-configuration)
+    - [Linux hotkey (i3)](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#linux-hotkey-i3)
+    - [macOS hotkey](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#macos-hotkey)
+      - [skhd](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#skhd)
+      - [Hammerspoon](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#hammerspoon)
+    - [Windows hotkey](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#windows-hotkey)
+- [Usage](#usage)
+- [The widget](#the-widget)
+- [Troubleshooting](#troubleshooting)
+- [License](#license)
+
+## Epistemology
+
+The name is based on morhook and voice. mor-vox. I know, if I explain the joke, it's not funny. Don't judge me.
+
+## Screenshots
+
+![capturing on a terminal](https://raw.githubusercontent.com/morhook/morvox/main/screenshot-terminal.png)
+![capturing on vscode](https://raw.githubusercontent.com/morhook/morvox/main/screenshot-vscode.png)
+![capturing on opencode](https://raw.githubusercontent.com/morhook/morvox/main/screenshot-opencode.png)
+![morvox recording inside opencode](https://raw.githubusercontent.com/morhook/morvox/main/screenshot-opencode-chicago-95-xfce.png)
+
+## What it does
+
+- It wraps whisper-cli and shows a VU meter on the user interface. You need to add the hotkey configuration on your OS/Desktop Environment.
+
+## Setup & installation
+
+Setup, dependencies, install steps, and hotkey configuration are in
+[`INSTALLATION.md`](https://github.com/morhook/morvox/blob/main/INSTALLATION.md).
+
+## Usage
+
+```sh
+# toggle (start, then stop+transcribe+type)
+morvox
+
+# fallback if you prefer module execution
+python -m morvox
+
+# status (for i3blocks / polybar)
+morvox --status        # prints "recording" or "idle"
+
+# abort an in-flight recording without transcribing
+morvox --cancel
+
+# keep the wav/txt around for debugging
+morvox --keep-temp
+
+# use a different model / source / typing speed
+morvox --model /path/to/ggml-tiny.en.bin
+morvox --source alsa_input.usb-Maono_Maonocaster…
+morvox --threads 8
+morvox --type-delay 5
+
+# disable the floating widget (headless / SSH / debugging)
+morvox --no-widget
+```
+
+From a source checkout, you can still run `./morvox` before installing.
+
+State files live in `$XDG_RUNTIME_DIR/morvox/` on Linux, falling back to
+`/tmp/morvox-$UID/` when `$XDG_RUNTIME_DIR` is unset;
+`~/Library/Caches/morvox/` on macOS; and `%LOCALAPPDATA%\morvox\` on
+Windows. Override with the `MORVOX_STATE_DIR` env var:
+
+- `rec.pid` — recorder PID
+- `target_window` — saved focused window id
+- `rec.wav` / `rec.txt` — audio + transcript
+- `parecord.log` / `whisper.log` — diagnostic logs
+
+By default these are deleted after a successful type. Pass `--keep-temp`
+to keep them.
+
+## The widget
+
+While recording, morvox shows a small borderless window centred near the
+bottom of the screen. It contains:
+
+- a pulsing red dot (recording indicator),
+- a live VU meter that reacts to your microphone level,
+- an elapsed-time counter.
+
+When you stop recording, the meter is replaced by a "Transcribing…"
+spinner that stays visible until whisper finishes and the transcript has
+been typed. If whisper produced only silence the widget briefly shows
+"No speech detected" instead.
+
+The widget is a self-spawned subprocess of `morvox` (uses Python's
+stdlib `tkinter`). Its stderr is written to the platform state dir's
+`widget.log` for debugging. On Linux/X11 it uses
+`_NET_WM_WINDOW_TYPE_DOCK` so i3 won't try to tile it. On Wayland-only
+sessions without XWayland, or on hosts without `$DISPLAY`, the widget is
+skipped silently.
+
+To disable the widget entirely (e.g. on a headless machine or over SSH),
+pass `--no-widget`.
+
+## Troubleshooting
+
+- **No audio recorded / empty wav (Linux)**
+  Check the active sources: `pactl list short sources`. Pass an explicit
+  source with `--source <NAME>`. Inspect
+  `$XDG_RUNTIME_DIR/morvox/parecord.log` or `/tmp/morvox-$UID/parecord.log`.
+
+- **No audio recorded / empty wav (macOS)**
+  List devices with `ffmpeg -f avfoundation -list_devices true -i ""`
+  and pass an explicit `--source :<idx>`. Inspect
+  `~/Library/Caches/morvox/parecord.log`. If ffmpeg complains about
+  permissions, grant the terminal Microphone access.
+
+- **No audio recorded / empty wav (Windows)**
+  List audio devices with `ffmpeg -list_devices true -f wasapi -i dummy`
+  (or `ffmpeg -list_devices true -f dshow -i dummy` if your ffmpeg build
+  lacks WASAPI) and pass an explicit `--source "<device name>"`. Inspect
+  `%LOCALAPPDATA%\morvox\parecord.log`. If ffmpeg cannot access the
+  microphone, check **Settings -> Privacy & security -> Microphone**.
+
+- **Text typed into wrong window**
+  On Linux and macOS, the originally focused window/app may have been
+  destroyed before you stopped recording. morvox falls back to typing
+  into whatever is currently focused and prints a warning to stderr. On
+  Windows, morvox intentionally types into the window that is focused
+  when transcription finishes.
+
+- **Linux Wayland: nothing is typed (GNOME/Ubuntu)**
+  GNOME/Mutter doesn't implement the `wtype` keyboard protocol and
+  `xdotool` is a no-op against native Wayland windows. Either set up
+  `ydotoold` (`sudo systemctl enable --now ydotoold` and add your user
+  to the `input` group), or install `wl-clipboard` so the transcript
+  lands on your clipboard for manual Ctrl+Shift+V. See
+  [`INSTALLATION.md` (Linux / Wayland)](https://github.com/morhook/morvox/blob/main/INSTALLATION.md#linux--wayland).
+
+- **Linux: widget never appears (asdf/pyenv/conda Python)**
+  The widget runs as a Python subprocess and needs `tkinter`. Many
+  third-party Python builds ship without it. Check
+  `$XDG_RUNTIME_DIR/morvox/widget.log` or `/tmp/morvox-$UID/widget.log` for
+  `No module named 'tkinter'`. Install `python3-tk` and run morvox under the
+  system Python, rebuild your managed Python with Tk support, or use
+  `--no-widget` to silence the warning.
+
+- **macOS: keystrokes silently do nothing**
+  Accessibility permission isn't granted. **System Settings → Privacy &
+  Security → Accessibility** → enable your terminal app.
+
+- **Windows: text does not type into an elevated app**
+  Windows blocks lower-integrity processes from injecting keystrokes into
+  elevated/admin windows. Run morvox from an elevated terminal too, or type
+  into a non-elevated app.
+
+- **Windows: transcript only appears on the clipboard**
+  On Windows 11, morvox first tries several automatic paste methods into the
+  currently focused window and then falls back to direct typing. If all of
+  those are blocked by the app or OS policy, morvox leaves the transcript on
+  the clipboard so you can paste it manually. Inspect
+  `%LOCALAPPDATA%\morvox\whisper.log` for a `windows-insert:` trace showing
+  which insertion path ran and what failed.
+
+- **Whisper too slow**
+  Use a smaller model — `ggml-tiny.en.bin` is roughly 5× faster than
+  `base.en` with a small accuracy hit. Increase `--threads` up to your
+  physical core count.
+
+- **Nothing is typed and notification says "Empty recording"**
+  Whisper produced only a noise token (e.g. `[BLANK_AUDIO]`). Speak
+  closer to the mic or check input gain.
+
+## License
+
+MIT — see [LICENSE](https://github.com/morhook/morvox/blob/main/LICENSE).

morvox-1.0.0/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "morvox"
+version = "1.0.0"
+description = "Offline push-to-talk voice-to-text CLI powered by whisper.cpp"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+  { name = "morhook", email = "cruz.fernandez@gmail.com" },
+]
+keywords = ["cli", "dictation", "speech-to-text", "voice", "whisper.cpp"]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Environment :: Console",
+  "Intended Audience :: End Users/Desktop",
+  "Natural Language :: English",
+  "Operating System :: MacOS",
+  "Operating System :: Microsoft :: Windows :: Windows 11",
+  "Operating System :: POSIX :: Linux",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Multimedia :: Sound/Audio :: Capture/Recording",
+  "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/morhook/morvox"
+Repository = "https://github.com/morhook/morvox"
+Issues = "https://github.com/morhook/morvox/issues"
+
+[project.scripts]
+morvox = "morvox.__main__:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

morvox-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

morvox-1.0.0/src/morvox/__main__.py

@@ -0,0 +1,83 @@
+"""morvox.__main__ — argparse wiring, CLI dispatch, and entry-point main()."""
+
+import argparse
+import os
+import sys
+
+from .constants import DEFAULT_MODEL
+from .state import _state, is_recording, read_pid, _pid_file
+from .commands import cmd_cancel, cmd_status
+from .recording import cmd_recorder, cmd_start, cmd_stop
+from .widget import cmd_widget
+
+
+def build_parser() -> argparse.ArgumentParser:
+    default_threads = max(1, (os.cpu_count() or 2) // 2)
+    p = argparse.ArgumentParser(
+        prog="morvox",
+        description=(
+            "Toggle audio capture and transcribe with whisper.cpp, then type the "
+            "transcription into a backend-selected target window."
+        ),
+    )
+    p.add_argument("--model", default=DEFAULT_MODEL,
+                   help=f"Path to whisper.cpp ggml model (default: {DEFAULT_MODEL})")
+    p.add_argument("--language", default="en", help="Whisper language code (default: en)")
+    p.add_argument("--threads", type=int, default=default_threads,
+                   help=f"Whisper thread count (default: {default_threads})")
+    p.add_argument("--source", default=None,
+                   help="Audio source/device name (default: system default)")
+    p.add_argument("--type-delay", type=int, default=1,
+                   help="Delay between typed characters in ms (default: 1)")
+    p.add_argument("--keep-temp", action="store_true",
+                   help="Keep temporary files after typing (default: delete)")
+    p.add_argument("--no-widget", action="store_true",
+                   help="Disable the live recording widget (headless mode)")
+    p.add_argument("--target-window", default=None, metavar="HANDLE",
+                   help=("Use a pre-captured target window handle "
+                         "(useful for hotkey launchers that steal focus)"))
+
+    mode = p.add_mutually_exclusive_group()
+    mode.add_argument("--status", action="store_true",
+                      help="Print 'recording' or 'idle' and exit")
+    mode.add_argument("--cancel", action="store_true",
+                      help="Cancel any active recording without transcribing/typing")
+    # Internal entry point used when morvox spawns its own GUI subprocess.
+    mode.add_argument("--widget", action="store_true",
+                      help=argparse.SUPPRESS)
+    mode.add_argument("--recorder", action="store_true",
+                      help=argparse.SUPPRESS)
+    return p
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+
+    # Ensure state dir exists for any sub-action.
+    _state()
+
+    if args.widget:
+        return cmd_widget()
+    if args.recorder:
+        return cmd_recorder(args)
+    if args.status:
+        return cmd_status()
+    if args.cancel:
+        return cmd_cancel(args)
+
+    # Toggle behavior.
+    if is_recording():
+        return cmd_stop(args)
+    else:
+        # Clean any stale leftovers from a previous failed run before starting.
+        if read_pid() is not None and not is_recording():
+            _pid_file().unlink(missing_ok=True)
+        return cmd_start(args)
+
+
+if __name__ == "__main__":
+    try:
+        sys.exit(main())
+    except KeyboardInterrupt:
+        sys.exit(130)

morvox-1.0.0/src/morvox/backends/__init__.py

@@ -0,0 +1,26 @@
+"""morvox.backends — backend selection and singleton."""
+
+import os
+import sys
+
+from .linux import LinuxX11Backend
+from .macos import MacOSBackend
+from .windows import WindowsBackend
+
+
+def _make_backend():
+    override = os.environ.get("MORVOX_BACKEND")
+    if override == "x11":
+        return LinuxX11Backend()
+    if override == "macos":
+        return MacOSBackend()
+    if override in ("windows", "win32"):
+        return WindowsBackend()
+    if sys.platform == "darwin":
+        return MacOSBackend()
+    if sys.platform == "win32":
+        return WindowsBackend()
+    return LinuxX11Backend()
+
+
+BACKEND = _make_backend()