Seamless speech-to-text at your fingertips, powered by OpenAI
Whispering is an open-source, cross-platform transcription app that harnesses the power of the OpenAI Whisper API to provide efficient speech-to-text conversion. It's designed to seamlessly integrate into your workflow, eliminating the need for manual transcription and streamlining your productivity.
Global Transcription: Access Whisper's speech-to-text functionality anywhere with a global keyboard shortcut or within two button clicks.
Cross-Platform Experience:
Chat Integration: The browser extension adds a recording button to ChatGPT and Claude websites, allowing direct voice input and transcription in the chat interface.
Transcription Management: Review and edit transcriptions within the Whispering app to ensure accuracy and clarity.
Automatic Clipboard Integration: Once transcription is complete, the text is automatically copied to your clipboard. An option for automatic pasting is also available.
https://github.com/braden-w/whispering/assets/13159333/e9d72422-a743-468f-858d-4ecde0dfe238
Sure, here's a revised version of the README with a more professional tone and best practices for the installation steps:
Visit whispering.bradenwong.com, which has the latest version of the apps/app
folder hosted on Vercel.
Install the Chrome Extension from the Chrome Web Store here.
To download and install the Whispering desktop app, follow the steps for your operating system:
.msi
from the latest releases page..msi
file to run the installer.More Info
-> Run Anyway
to proceed with the installation..dmg
from the latest releases page..dmg
file to run the installer.Cancel
, then right-click the app in Finder and select Open
.After installation, the app will be ready to use.
For Linux, there are multiple installation options available. Choose the one that suits your environment:
AppImage:
.AppImage
file from the latest releases page.chmod +x whispering_x.x.x_amd64.AppImage
./whispering_x.x.x_amd64.AppImage
DEB Package (Debian/Ubuntu):
.deb
file from the latest releases page.dpkg
:
sudo dpkg -i whispering_x.x.x_amd64.deb
sudo apt-get install -f
After installation, the app will be ready to use.
After installing the Chrome Extension, you will find a Whispering icon on the Chrome extensions bar. Click on this icon to open the extension. To use the Whisper API feature, simply click the 'Start Recording' microphone button to record your voice, and then 'Stop Recording' square button when you're done. Your transcription will appear in the text box below.
To access the ChatGPT feature, navigate to the ChatGPT web page. You'll see a new recording button in the chat interface. Click this button to start and stop recording, and the transcribed text will be automatically inserted into the chat input field.
To access the shortcut feature, press Control + Shift + X or Command + Shift + X to start recording from any website. The transcription will be automatically copied into your clipboard and paste into the current input field.
To start using the Whispering web app, click the button below:
After installing the Whispering desktop app, press Control + Shift + ; or Command + Shift + ; to start recording from anywhere on your desktop. The application will come into focus while recording, and will minimize when you stop recording. The transcription will be automatically copied into your clipboard and can be configured to automatically paste.
Whispering web and desktop app is built using the following technologies and libraries:
The Whispering Chrome extension is built using:
To set up the project on your local machine, follow these steps:
git clone https://github.com/braden-w/whispering.git
cd whispering
pnpm i
To run the Whispering desktop app and website in development mode:
cd apps/app
pnpm tauri dev
The desktop app should automatically open for local development. To develop the web app, open your browser and navigate to http://localhost:5173
.
To run the Whispering Chrome extension in development mode:
cd apps/extension
pnpm dev --target=chrome-mv3
To develop the chrome extension, load it into Chrome by navigating to chrome://extensions
, enabling developer mode, and loading the apps/extension/build/{platform}-{manifest-version}-dev
folder as an unpacked extension.
If you ever have concerns regarding the trustworthiness of the installers or would like more control, you can always build the executable yourself. This requires more setup, but it ensures that you are running the code you expect. Such is the beauty of open-source software!
cd apps/extension
pnpm i
pnpm plasmo build --target=chrome-mv3
apps/extension/build/chrome-mv3-prod
, which can be loaded into Chrome as an unpacked extension.pnpm plasmo build --target=chrome-mv3 --release
cd apps/extension
pnpm i
pnpm plasmo build --target=firefox-mv3
apps/extension/build/firefox-mv3-prod
, which can be loaded into Chrome as an unpacked extension.pnpm plasmo build --target=firefox-mv3 --release
cd apps/app
pnpm i
pnpm tauri build
apps/app/target/release
directory.We welcome contributions from the community! If you'd like to contribute to Whispering, please follow these steps:
git checkout -b feature/your-feature-name
or git checkout -b fix/your-bugfix-name
git push origin your-branch-name
Please ensure your code follows established conventions and is well-documented.
Whispering is released under the MIT License.
This project is supported by the following amazing people and organizations:
If you encounter any issues or have suggestions for improvements, please open an issue on the GitHub iusses tab. I really appreciate your feedback!
Thank you for using Whispering and happy writing!