Technical solutions for full platform adaptation
CapsWriter-Offline has the following adaptation scheme for cross-platform scenarios:
Windows system
- Make sure your system version is Win10 1809 or newer, older systems need to install the Universal C Runtime update.
- 32-bit systems can only run the client, you need to modify the server_address in the client_config.json to connect to the services provided by 64-bit devices on the LAN.
macOS
- Install dependencies via Homebrew: brew install protobuf && brew install portaudio
- Permission problem solution: Enable microphone and auxiliary function permission in System Preferences → Security & Privacy
- Shortcut conflict handling: Modify config.py to change shortcut to a non-useful key such as F13.
Linux system
- Base dependencies: sudo apt-get install python3-pyaudio xclip
- Sound card configuration: check /etc/asound.conf to make sure the default recording device is correct
- No GUI environment: Enable X11 forwarding support for clipboard via ssh -X
Generic solution: For ARM architecture devices (e.g. M1 Mac), it is recommended to deploy using Docker containers (Dockerfile is provided with the project) or wait for a community-compiled ARM-specific version.
This answer comes from the articleCapsWriter-Offline: Speech Input and Subtitle Transcription Tool for the PCThe































