theJayTea/WritingTools

📋 Changes

• Added support for the Gemma 4 series as an option!
• Uses `Gemini Flash Lite Latest` as the new default model, because at least right now, Gemma 4 is *really* slow on Google's end -- at least for the free API. Might get better in the future!
• Per-button hotkeys! Finally :D *(click the "Edit" icon at the top left of the pop-up to tweak the buttons!)*
• Significantly improved stability on all PCs!
• The Writing Tools pop-up now shows up significantly faster
• Deprecated the "Chat with your AI" pop-up that showed when no text was selected.

📦 Known Issues:

• 1. On some devices, Writing Tools may not work correctly with the default hotkey.
• To fix it, simply change the default ctrl+space hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---
• ---
• ---
• The user interface has been refined based on the Human Interface Guidelines (HIG).
• Command instructions have been updated (thanks, Balázs!).
• + 10 more

🐛 1. ✨New updated Gemini / Gemma models! Fixes any "quota exceeded" errors.

• Overnight, Google slashed usage limits on the free Gemini API.
• Writing Tools used the slightly outdated 2.0 model family, which got booted off the free tier (thus the errors).
• 2.5 Flash and 2.5 Flash Lite are slashed to a tiny 20 requests per day (welp!)
• Writing Tools now defaults to using `Gemma 3 27B`, which is a very, very intelligent model that runs incredibly quick and is notably more intelligent than the previous Gemini Flash model!
• Writing Tools also has a new `Custom` Gemini model option, so you can choose your own Gemini model regardless of what the dropdown lets you choose.
• <img width="1171" height="560" alt="image" src="https://github.com/user-attachments/assets/dcb8c919-a8c2-4794-bd47-3318d91307cd" />

🔒 2. 🔒 Improved security for on-device Gemini API key storage

• Your Gemini API key was always safe and never sent anywhere except straight to Google, and was stored *only* on your local device in your `config.json` file.
• To further bolster security, I now store your API key heavily encrypted with a custom encryption algorithm.
• This way, if you ever happen to get malware that tries to search your entire hard drive for API keys, your Gemini key will be safe.

✨ 3. ⬆️ New Easy Update Logic!

• You simply need to drag and drop the new `Writing Tools.exe` to replace your old one!
• On first launch, if you'd been using Gemini before, it'll automatically migrate you to the new `Gemma 3 27B` model and also encrypt your previously saved Gemini API key :)

✨ Upcoming features:

• Per-button hotkeys and model choice
• Significantly improving stability on all PCs
• Localization (multi-language UI) — @momokrono has [built the entire framework](https://github.com/theJayTea/WritingTools/discussions/92) for this, and my gratitude is unbounded — this would help so many. It'll be ready by the next release!
• Checking that the active window is the same before pasting.
• And more! See my [Windows/Linux Version Feature Roadmap](https://github.com/theJayTea/WritingTools/issues/206)!

📦 Known Issues

• 1. On some devices, Writing Tools may not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---
• ---
• ---
• 6.1:
• The user interface has been refined based on the Human Interface Guidelines (HIG).
• + 18 more

🐛 1. ✨New updated Gemini / Gemma models! Fixes any "quota exceeded" errors.

• Overnight, Google slashed usage limits on the free Gemini API.
• Writing Tools used the slightly outdated 2.0 model family, which got booted off the free tier (thus the errors).
• 2.5 Flash and 2.5 Flash Lite are slashed to a tiny 20 requests per day (welp!)
• Writing Tools now defaults to using `Gemma 3 27B`, which is a very, very intelligent model that runs incredibly quick and is notably more intelligent than the previous Gemini Flash model!
• Writing Tools also has a new `Custom` Gemini model option, so you can choose your own Gemini model regardless of what the dropdown lets you choose.
• <img width="1171" height="560" alt="image" src="https://github.com/user-attachments/assets/dcb8c919-a8c2-4794-bd47-3318d91307cd" />

🔒 2. 🔒 Improved security for on-device Gemini API key storage

• Your Gemini API key was always safe and never sent anywhere except straight to Google, and was stored *only* on your local device in your `config.json` file.
• To further bolster security, I now store your API key heavily encrypted with a custom encryption algorithm.
• This way, if you ever happen to get malware that tries to search your entire hard drive for API keys, your Gemini key will be safe.

✨ 3. ⬆️ New Easy Update Logic!

• You simply need to drag and drop the new `Writing Tools.exe` to replace your old one!
• On first launch, if you'd been using Gemini before, it'll automatically migrate you to the new `Gemma 3 27B` model and also encrypt your previously saved Gemini API key :)

✨ Upcoming features:

• Per-button hotkeys and model choice
• Significantly improving stability on all PCs
• Localization (multi-language UI) — @momokrono has [built the entire framework](https://github.com/theJayTea/WritingTools/discussions/92) for this, and my gratitude is unbounded — this would help so many. It'll be ready by the next release!
• Checking that the active window is the same before pasting.
• And more! See my [Windows/Linux Version Feature Roadmap](https://github.com/theJayTea/WritingTools/issues/206)!

📦 Known Issues

• 1. On some devices, Writing Tools may not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---
• ---
• ---
• Happy New Year 2026!
• This release brings the following changes:
• + 10 more

🐛 1. ✨New updated Gemini / Gemma models! Fixes any "quota exceeded" errors.

• Overnight, Google slashed usage limits on the free Gemini API.
• Writing Tools used the slightly outdated 2.0 model family, which got booted off the free tier (thus the errors).
• 2.5 Flash and 2.5 Flash Lite are slashed to a tiny 20 requests per day (welp!)
• Writing Tools now defaults to using `Gemma 3 27B`, which is a very, very intelligent model that runs incredibly quick and is notably more intelligent than the previous Gemini Flash model!
• Writing Tools also has a new `Custom` Gemini model option, so you can choose your own Gemini model regardless of what the dropdown lets you choose.
• <img width="1171" height="560" alt="image" src="https://github.com/user-attachments/assets/dcb8c919-a8c2-4794-bd47-3318d91307cd" />

🔒 2. 🔒 Improved security for on-device Gemini API key storage

• Your Gemini API key was always safe and never sent anywhere except straight to Google, and was stored *only* on your local device in your `config.json` file.
• To further bolster security, I now store your API key heavily encrypted with a custom encryption algorithm.
• This way, if you ever happen to get malware that tries to search your entire hard drive for API keys, your Gemini key will be safe.

✨ 3. ⬆️ New Easy Update Logic!

• You simply need to drag and drop the new `Writing Tools.exe` to replace your old one!
• On first launch, if you'd been using Gemini before, it'll automatically migrate you to the new `Gemma 3 27B` model and also encrypt your previously saved Gemini API key :)

✨ Upcoming features:

• Per-button hotkeys and model choice
• Significantly improving stability on all PCs
• Localization (multi-language UI) — @momokrono has [built the entire framework](https://github.com/theJayTea/WritingTools/discussions/92) for this, and my gratitude is unbounded — this would help so many. It'll be ready by the next release!
• Checking that the active window is the same before pasting.
• And more! See my [Windows/Linux Version Feature Roadmap](https://github.com/theJayTea/WritingTools/issues/206)!

📦 Known Issues

• 1. On some devices, Writing Tools may not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---
• ---
• ---
• Added text size persistence in response view by @gdmka
• Fixed OpenAI-compatible API failure with custom Base URL by @drankush
• + 7 more

🐛 v7.1 Hotfix Additions:

• Fixed an issue with the OpenAI Provider, and improved & optimised the entire AI Provider architecture.
• Improved the thinking text animation.
• Fixed the default icon arrangement to be the same as v6.

✨ Huge thanks to @momokrono for building the *entire* back-end for this 💛! I added the GUI (with draggable buttons, reset to default functionality...).

• 

📦 2. Sleeker pop-up UI

• 

📦 3. A native Ollama AI Provider (using the Ollama API), for easier Ollama setup & custom model-in-memory-time options — entirely thanks to @momokrono!

• 

✨ 4. New Gemini model options, with better explanations

• 

✨ 5. A new `Pause` & `Resume` option to stop Writing Tools from reading your hotkey if necessary. Again, @momokrono so awesomely implemented this :D

• 

📦 5. Other Improvements:

• UX improvements to the Summary etc. pop-up window (optimized initial height)
• Friendlier error message on hitting Gemini rate-limits
• Added graceful quitting when running through the terminal [credit: @momokrono]

✨ Upcoming features:

• Localization (multi-language UI) — @momokrono has [built the entire framework](https://github.com/theJayTea/WritingTools/discussions/92) for this, and my gratitude is unbounded — this would help so many. It'll be ready by the next release!
• Hotkeys for specific options.
• Support to remove reasoning token markers if needed ([PS: DeepSeek R1 & Gemini 2.0 Thinking already work!](https://github.com/theJayTea/WritingTools/issues/109#issuecomment-2614060989)).
• (researching) Tracked changes/diff check (to compare proofread text with the original).
• Checking that the active window is the same before pasting.
• More feature suggestions on GitHub Issues, and potentially future ones.
• And of course, bug fixes and improvements overall :]

📦 ⬆️ Update Instructions:

• You can keep using your old `config.json` to preserve your set-up! Simply bring it over into the new `Writing Tools v7.1` folder you'll download below.

📦 🐞 Known Issues

• 1. On some devices, Writing Tools may not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---
• ---
• ---
• Improved UI across the app
• Improved Accessibility
• + 13 more

🐛 v7.1 Hotfix Additions:

• Fixed an issue with the OpenAI Provider, and improved & optimised the entire AI Provider architecture.
• Improved the thinking text animation.
• Fixed the default icon arrangement to be the same as v6.

✨ Huge thanks to @momokrono for building the *entire* back-end for this 💛! I added the GUI (with draggable buttons, reset to default functionality...).

• 

📦 2. Sleeker pop-up UI

• 

📦 3. A native Ollama AI Provider (using the Ollama API), for easier Ollama setup & custom model-in-memory-time options — entirely thanks to @momokrono!

• 

✨ 4. New Gemini model options, with better explanations

• 

✨ 5. A new `Pause` & `Resume` option to stop Writing Tools from reading your hotkey if necessary. Again, @momokrono so awesomely implemented this :D

• 

📦 5. Other Improvements:

• UX improvements to the Summary etc. pop-up window (optimized initial height)
• Friendlier error message on hitting Gemini rate-limits
• Added graceful quitting when running through the terminal [credit: @momokrono]

✨ Upcoming features:

• Localization (multi-language UI) — @momokrono has [built the entire framework](https://github.com/theJayTea/WritingTools/discussions/92) for this, and my gratitude is unbounded — this would help so many. It'll be ready by the next release!
• Hotkeys for specific options.
• Support to remove reasoning token markers if needed ([PS: DeepSeek R1 & Gemini 2.0 Thinking already work!](https://github.com/theJayTea/WritingTools/issues/109#issuecomment-2614060989)).
• (researching) Tracked changes/diff check (to compare proofread text with the original).
• Checking that the active window is the same before pasting.
• More feature suggestions on GitHub Issues, and potentially future ones.
• And of course, bug fixes and improvements overall :]

📦 ⬆️ Update Instructions:

• You can keep using your old `config.json` to preserve your set-up! Simply bring it over into the new `Writing Tools v7.1` folder you'll download below.

📦 🐞 Known Issues

• 1. On some devices, Writing Tools may not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---
• ---
• ---
• Updated AI providers: New cloud and local AI models (Gemma 3, Gemma 3n, Gemini 2.5, etc.).
• iCloud support for commands.
• + 10 more

✨ Upcoming Features:

• Text streaming in the response window.
• Better support for reasoning models.
• Context Menu Support

🐛 v7.1 Hotfix Additions:

• Fixed an issue with the OpenAI Provider, and improved & optimised the entire AI Provider architecture.
• Improved the thinking text animation.
• Fixed the default icon arrangement to be the same as v6.

✨ Huge thanks to @momokrono for building the *entire* back-end for this 💛! I added the GUI (with draggable buttons, reset to default functionality...).

• 

📦 2. Sleeker pop-up UI

• 

📦 3. A native Ollama AI Provider (using the Ollama API), for easier Ollama setup & custom model-in-memory-time options — entirely thanks to @momokrono!

• 

✨ 4. New Gemini model options, with better explanations

• 

✨ 5. A new `Pause` & `Resume` option to stop Writing Tools from reading your hotkey if necessary. Again, @momokrono so awesomely implemented this :D

• 

📦 5. Other Improvements:

• UX improvements to the Summary etc. pop-up window (optimized initial height)
• Friendlier error message on hitting Gemini rate-limits
• Added graceful quitting when running through the terminal [credit: @momokrono]

✨ Upcoming features:

• Localization (multi-language UI) — @momokrono has [built the entire framework](https://github.com/theJayTea/WritingTools/discussions/92) for this, and my gratitude is unbounded — this would help so many. It'll be ready by the next release!
• Hotkeys for specific options.
• Support to remove reasoning token markers if needed ([PS: DeepSeek R1 & Gemini 2.0 Thinking already work!](https://github.com/theJayTea/WritingTools/issues/109#issuecomment-2614060989)).
• (researching) Tracked changes/diff check (to compare proofread text with the original).
• Checking that the active window is the same before pasting.
• More feature suggestions on GitHub Issues, and potentially future ones.
• And of course, bug fixes and improvements overall :]

📦 ⬆️ Update Instructions:

• You can keep using your old `config.json` to preserve your set-up! Simply bring it over into the new `Writing Tools v7.1` folder you'll download below.

📦 🐞 Known Issues

• 1. On some devices, Writing Tools may not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---
• ---
• ---
• New AI Providers: OpenRouter and Anthropic are now available in the app, and they both support native image recognition thanks to [AIProxySwift](https://github.com/lzell/AIProxySwift)!
• Fixed Window Size when editing built in commands.

📦 v4.1 Release Notes:

• Revamped Local LLM page: You can now select either an LLM with OCR or a VLM with direct image recognition.
• New Local AI Models: Qwen 3.0 4B, Gemma 2 2B, Qwen2.5 VL
• Fixed Permission Issue: Fixed the annoying bug that plagued previous versions. For future updates you no longer have to reset the permissions after each update. However, if you are using a previous version, you would still have to re-enable accessibility access one last time:
• > System Settings → Privacy & Security → Accessibility → Select *writing-tools* → Press the minus (–) button → Press the plus (+) button → Add *writing-tools* again and enable access.

📦 v4 Release Notes:

• Integrated [AIProxySwift](https://github.com/lzell/AIProxySwift) for all providers.
• Image Recognition in Finder: Simply open WritingTools on the desired image in Finder, and it will be recognized by the app.
• Image Support for All Providers:
• Some providers like Google and OpenAI have native image support via their APIs, which is fully utilized here.
• Others, like Mistral and Local LLM, use OCR and Apple Vision for text recognition on images.
• For Ollama, you can choose between native support (if your AI model supports it) or OCR via Settings.
• Keyboard Shortcuts for Each Tool:
• You can set up separate shortcuts for each tool in its Edit Page.
• + 12 more

✨ Upcoming Features:

• Text streaming in the response window.
• Better support for reasoning models.
• Retain formatting styles after pasting.
• Gemma 3 support as soon as it is completed by the MLX team.
• Support for documents.

🐛 v7.1 Hotfix Additions:

• Fixed an issue with the OpenAI Provider, and improved & optimised the entire AI Provider architecture.
• Improved the thinking text animation.
• Fixed the default icon arrangement to be the same as v6.

✨ Huge thanks to @momokrono for building the *entire* back-end for this 💛! I added the GUI (with draggable buttons, reset to default functionality...).

• 

📦 2. Sleeker pop-up UI

• 

📦 3. A native Ollama AI Provider (using the Ollama API), for easier Ollama setup & custom model-in-memory-time options — entirely thanks to @momokrono!

• 

✨ 4. New Gemini model options, with better explanations

• 

✨ 5. A new `Pause` & `Resume` option to stop Writing Tools from reading your hotkey if necessary. Again, @momokrono so awesomely implemented this :D

• 

📦 5. Other Improvements:

• UX improvements to the Summary etc. pop-up window (optimized initial height)
• Friendlier error message on hitting Gemini rate-limits
• Added graceful quitting when running through the terminal [credit: @momokrono]

✨ Upcoming features:

• Localization (multi-language UI) — @momokrono has [built the entire framework](https://github.com/theJayTea/WritingTools/discussions/92) for this, and my gratitude is unbounded — this would help so many. It'll be ready by the next release!
• Hotkeys for specific options.
• Support to remove reasoning token markers if needed ([PS: DeepSeek R1 & Gemini 2.0 Thinking already work!](https://github.com/theJayTea/WritingTools/issues/109#issuecomment-2614060989)).
• (researching) Tracked changes/diff check (to compare proofread text with the original).
• Checking that the active window is the same before pasting.
• More feature suggestions on GitHub Issues, and potentially future ones.
• And of course, bug fixes and improvements overall :]

📦 ⬆️ Update Instructions:

• You can keep using your old `config.json` to preserve your set-up! Simply bring it over into the new `Writing Tools v7.1` folder you'll download below.

📦 🐞 Known Issues

• 1. On some devices, Writing Tools may not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---
• ---
• ---
• Revamped Local LLM page: You can now select either an LLM with OCR or a VLM with direct image recognition.
• New Local AI Models: Qwen 3.0 4B, Gemma 2 2B, Qwen2.5 VL
• + 2 more

📦 v4 Release Notes:

• Integrated [AIProxySwift](https://github.com/lzell/AIProxySwift) for all providers.
• Image Recognition in Finder: Simply open WritingTools on the desired image in Finder, and it will be recognized by the app.
• Image Support for All Providers:
• Some providers like Google and OpenAI have native image support via their APIs, which is fully utilized here.
• Others, like Mistral and Local LLM, use OCR and Apple Vision for text recognition on images.
• For Ollama, you can choose between native support (if your AI model supports it) or OCR via Settings.
• Keyboard Shortcuts for Each Tool:
• You can set up separate shortcuts for each tool in its Edit Page.
• + 11 more

✨ Upcoming Features:

• Text streaming in the response window.
• Better support for reasoning models.
• Gemma 3 support as soon as it is completed by the MLX team.
• Support for videos and links via Gemini.
• Still testing: evaluating the possibility of using a Core ML or `llama.cpp` model instead of MLX — which should, theoretically, allow Local LLM to run on Intel Macs as well.

🐛 v7.1 Hotfix Additions:

• Fixed an issue with the OpenAI Provider, and improved & optimised the entire AI Provider architecture.
• Improved the thinking text animation.
• Fixed the default icon arrangement to be the same as v6.

✨ Huge thanks to @momokrono for building the *entire* back-end for this 💛! I added the GUI (with draggable buttons, reset to default functionality...).

• 

📦 2. Sleeker pop-up UI

• 

📦 3. A native Ollama AI Provider (using the Ollama API), for easier Ollama setup & custom model-in-memory-time options — entirely thanks to @momokrono!

• 

✨ 4. New Gemini model options, with better explanations

• 

✨ 5. A new `Pause` & `Resume` option to stop Writing Tools from reading your hotkey if necessary. Again, @momokrono so awesomely implemented this :D

• 

📦 5. Other Improvements:

• UX improvements to the Summary etc. pop-up window (optimized initial height)
• Friendlier error message on hitting Gemini rate-limits
• Added graceful quitting when running through the terminal [credit: @momokrono]

✨ Upcoming features:

• Localization (multi-language UI) — @momokrono has [built the entire framework](https://github.com/theJayTea/WritingTools/discussions/92) for this, and my gratitude is unbounded — this would help so many. It'll be ready by the next release!
• Hotkeys for specific options.
• Support to remove reasoning token markers if needed ([PS: DeepSeek R1 & Gemini 2.0 Thinking already work!](https://github.com/theJayTea/WritingTools/issues/109#issuecomment-2614060989)).
• (researching) Tracked changes/diff check (to compare proofread text with the original).
• Checking that the active window is the same before pasting.
• More feature suggestions on GitHub Issues, and potentially future ones.
• And of course, bug fixes and improvements overall :]

📦 ⬆️ Update Instructions:

• You can keep using your old `config.json` to preserve your set-up! Simply bring it over into the new `Writing Tools v7.1` folder you'll download below.

📦 🐞 Known Issues

• 1. On some devices, Writing Tools may not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---
• ---
• ---
• Integrated [AIProxySwift](https://github.com/lzell/AIProxySwift) for all providers.
• Image Recognition in Finder: Simply open WritingTools on the desired image in Finder, and it will be recognized by the app.
• + 17 more

✨ Upcoming Features:

• Text streaming in the response window.
• Better support for reasoning models.
• Gemma 3 support as soon as it is completed by the MLX team.
• Support for videos and links via Gemini.
• Still testing: evaluating the possibility of using a Core ML or `llama.cpp` model instead of MLX — which should, theoretically, allow Local LLM to run on Intel Macs as well.

🐛 v7.1 Hotfix Additions:

• Fixed an issue with the OpenAI Provider, and improved & optimised the entire AI Provider architecture.
• Improved the thinking text animation.
• Fixed the default icon arrangement to be the same as v6.

✨ Huge thanks to @momokrono for building the *entire* back-end for this 💛! I added the GUI (with draggable buttons, reset to default functionality...).

• 

📦 2. Sleeker pop-up UI

• 

📦 3. A native Ollama AI Provider (using the Ollama API), for easier Ollama setup & custom model-in-memory-time options — entirely thanks to @momokrono!

• 

✨ 4. New Gemini model options, with better explanations

• 

✨ 5. A new `Pause` & `Resume` option to stop Writing Tools from reading your hotkey if necessary. Again, @momokrono so awesomely implemented this :D

• 

📦 5. Other Improvements:

• UX improvements to the Summary etc. pop-up window (optimized initial height)
• Friendlier error message on hitting Gemini rate-limits
• Added graceful quitting when running through the terminal [credit: @momokrono]

✨ Upcoming features:

• Localization (multi-language UI) — @momokrono has [built the entire framework](https://github.com/theJayTea/WritingTools/discussions/92) for this, and my gratitude is unbounded — this would help so many. It'll be ready by the next release!
• Hotkeys for specific options.
• Support to remove reasoning token markers if needed ([PS: DeepSeek R1 & Gemini 2.0 Thinking already work!](https://github.com/theJayTea/WritingTools/issues/109#issuecomment-2614060989)).
• (researching) Tracked changes/diff check (to compare proofread text with the original).
• Checking that the active window is the same before pasting.
• More feature suggestions on GitHub Issues, and potentially future ones.
• And of course, bug fixes and improvements overall :]

📦 ⬆️ Update Instructions:

• You can keep using your old `config.json` to preserve your set-up! Simply bring it over into the new `Writing Tools v7.1` folder you'll download below.

📦 🐞 Known Issues

• 1. On some devices, Writing Tools may not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---
• ---
• ---
• Complete new tool management system to fix current issues.
• Added checks to disable Local LLM on Intel Macs. This should prevent the crashes.
• + 3 more

📦 Release notes for macOS v3:

• Almost everything new in Windows v7.1.
• Integrated Local LLM (Llama 3.2 3B), the app now can work without any API Keys or Ollama. Please note that the LLM must be downloaded via Settings.
• Support for German and French.
• Ability to close the Popup Window via ESC Key.
• Bug fixes.

✨ Upcoming features:

• Text Streaming in response window.
• Better support for reasoning models.
• Support for Videos and Links via Gemini.
• Image support on all Providers
• Still testing: I am testing and seeing if it is possible to use a Core ML Model instead of MLX. This should theoretically allow Local LLM to run on Intel Macs, too.

🐛 v7.1 Hotfix Additions:

• Fixed an issue with the OpenAI Provider, and improved & optimised the entire AI Provider architecture.
• Improved the thinking text animation.
• Fixed the default icon arrangement to be the same as v6.

✨ Huge thanks to @momokrono for building the *entire* back-end for this 💛! I added the GUI (with draggable buttons, reset to default functionality...).

• 

📦 2. Sleeker pop-up UI

• 

📦 3. A native Ollama AI Provider (using the Ollama API), for easier Ollama setup & custom model-in-memory-time options — entirely thanks to @momokrono!

• 

✨ 4. New Gemini model options, with better explanations

• 

✨ 5. A new `Pause` & `Resume` option to stop Writing Tools from reading your hotkey if necessary. Again, @momokrono so awesomely implemented this :D

• 

📦 5. Other Improvements:

• UX improvements to the Summary etc. pop-up window (optimized initial height)
• Friendlier error message on hitting Gemini rate-limits
• Added graceful quitting when running through the terminal [credit: @momokrono]

✨ Upcoming features:

• Localization (multi-language UI) — @momokrono has [built the entire framework](https://github.com/theJayTea/WritingTools/discussions/92) for this, and my gratitude is unbounded — this would help so many. It'll be ready by the next release!
• Hotkeys for specific options.
• Support to remove reasoning token markers if needed ([PS: DeepSeek R1 & Gemini 2.0 Thinking already work!](https://github.com/theJayTea/WritingTools/issues/109#issuecomment-2614060989)).
• (researching) Tracked changes/diff check (to compare proofread text with the original).
• Checking that the active window is the same before pasting.
• More feature suggestions on GitHub Issues, and potentially future ones.
• And of course, bug fixes and improvements overall :]

📦 ⬆️ Update Instructions:

• You can keep using your old `config.json` to preserve your set-up! Simply bring it over into the new `Writing Tools v7.1` folder you'll download below.

📦 🐞 Known Issues

• 1. On some devices, Writing Tools may not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---
• ---
• ---
• New Feature: Image Processing via Gemini (Thanks to @Joaov41. GitHub: [https://github.com/Joaov41](https://github.com/Joaov41))
• Added direct Mistral support
• + 3 more

✨ Upcoming features:

• Text streaming in the Response Window
• Localisation of the buttons for some languages
• Ability to close the Popup Window via ESC Key
• Ability to work with an embedded local LLM without any configuration

✨ HUGE thanks to @momokrono for building the *entire* back-end for this 💛! I added the GUI (with draggable buttons, reset to default functionality...).

• 

📦 2. Sleeker pop-up UI

• 

📦 3. A native Ollama AI Provider (using the Ollama API), for easier Ollama setup & custom model-in-memory-time options — entirely thanks to @momokrono!

• 

✨ 4. New Gemini model options, with better explanations

• 

✨ 5. A new `Pause` & `Resume` option to stop Writing Tools from reading your hotkey if necessary. Again, @momokrono so awesomely implemented this :D

• 

📦 5. Other Improvements:

• UX improvements to the Summary etc. pop-up window (optimized initial height)
• Friendlier error message on hitting Gemini rate-limits
• Added graceful quitting when running through the terminal [credit: @momokrono]

✨ Upcoming features:

• Localization (multi-language UI) — @momokrono has [built the entire framework](https://github.com/theJayTea/WritingTools/discussions/92) for this, and my gratitude is unbounded — this would help so many. It'll be ready by the next release!
• Hotkeys for specific options.
• Support to remove reasoning token markers if needed ([PS: DeepSeek R1 & Gemini 2.0 Thinking already work!](https://github.com/theJayTea/WritingTools/issues/109#issuecomment-2614060989)).
• (researching) Tracked changes/diff check (to compare proofread text with the original).
• Checking that the active window is the same before pasting.
• More feature suggestions on GitHub Issues, and potentially future ones.

📦 ⬆️ Update Instructions:

• You can keep using your old `config.json` to preserve your set-up! Simply bring it over into the new `Writing Tools v7` folder you'll download below.

📦 🐞 Known Issues

• 1. On some devices, Writing Tools may not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---
• ---
• ---
• New Feature: Image Processing via Gemini (Thanks to @Joaov41. GitHub: [https://github.com/Joaov41](https://github.com/Joaov41))
• Added direct Mistral support
• + 3 more

✨ Upcoming features:

• Text streaming in the Response Window
• Localisation of the buttons for some languages
• Ability to close the Popup Window via ESC Key
• Ability to work with an embedded local LLM without any configuration

📦 1. Improvements to the Summary/Key Points/Table/Chat window — you can now:

• Chat with the summary! You can for more details on particular parts, or ask it to explain things. The chat history is preserved until you close the window.
• Copy the response as markdown.
• I also added a sweet tiny "Thinking..." animation haha.
• 

📦 3. The Writing Tools Chat Mode (when you invoke Writing Tools without selecting any text) now shows its response in a proper Chat window. So you can now have a quick chat with an LLM with one click, anywhere.

• https://github.com/user-attachments/assets/34dab06b-726d-46c2-a23f-dad7b81cd6a2

✨ 4. There's now an automatic check for updates feature, which checks for a new version by pinging [a file in this repo](https://github.com/theJayTea/WritingTools/blob/main/Windows_and_Linux/Latest_Version_for_Update_Check.txt) on the initial Writing Tools launch. It'll never annoy you with any pop-up notice or notification — just a small message on the Writing Tools pop-up itself :)

• <img width="226" alt="image" src="https://github.com/user-attachments/assets/5ff34406-1a67-4a6c-8ff0-b3a19c151180" />

✨ Upcoming features:

• Editable buttons! (you'll be able to re-arrange buttons, create your own, and edit their prompts).
• More of the feature suggestions in the Issues page.

📦 ⬆️ Update Instructions:

• Delete your old Writing Tools folder and download the new one (the config file format has changed).

📦 🐞 Known Issues

• 1. On some devices, Writing Tools may not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---
• ---
• ---
• New Feature: Image Processing via Gemini (Thanks to @Joaov41. GitHub: [https://github.com/Joaov41](https://github.com/Joaov41))
• Added direct Mistral support
• + 3 more

✨ Upcoming features:

• Text streaming in the Response Window
• Localisation of the buttons for some languages
• Ability to close the Popup Window via ESC Key
• Ability to work with an embedded local LLM without any configuration

📦 1. Improvements to the Summary/Key Points/Table/Chat window — you can now:

• Chat with the summary! You can for more details on particular parts, or ask it to explain things. The chat history is preserved until you close the window.
• Copy the response as markdown.
• I also added a sweet tiny "Thinking..." animation haha.
• 

📦 3. The Writing Tools Chat Mode (when you invoke Writing Tools without selecting any text) now shows its response in a proper Chat window. So you can now have a quick chat with an LLM with one click, anywhere.

• https://github.com/user-attachments/assets/34dab06b-726d-46c2-a23f-dad7b81cd6a2

✨ 4. There's now an automatic check for updates feature, which checks for a new version by pinging [a file in this repo](https://github.com/theJayTea/WritingTools/blob/main/Windows_and_Linux/Latest_Version_for_Update_Check.txt) on the initial Writing Tools launch. It'll never annoy you with any pop-up notice or notification — just a small message on the Writing Tools pop-up itself :)

• <img width="226" alt="image" src="https://github.com/user-attachments/assets/5ff34406-1a67-4a6c-8ff0-b3a19c151180" />

✨ Upcoming features:

• Editable buttons! (you'll be able to re-arrange buttons, create your own, and edit their prompts).
• More of the feature suggestions in the Issues page.

📦 ⬆️ Update Instructions:

• Delete your old Writing Tools folder and download the new one (the config file format has changed).

📦 🐞 Known Issues

• 1. On some devices, Writing Tools may not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---
• ---
• ---
• Replaced the custom keyboard shortcut recorder [with the amazing package](https://github.com/sindresorhus/KeyboardShortcuts) developed by @sindresorhus. This is very stable and is the same package that the ChatGPT app for macOS uses.
• Added a Glassmorphic design option in settings for those that enjoy it and want something more in line with Apple design language.
• + 4 more

✨ Upcoming features:

• Localisation of the buttons for some languages.
• Support for Mistral API (EU users may like this as Mistral won't send any data outside of the EU due to regulations).
• Text streaming in the Response Window.
• Bug fixes (always :D).

📦 1. Improvements to the Summary/Key Points/Table/Chat window — you can now:

• Chat with the summary! You can for more details on particular parts, or ask it to explain things. The chat history is preserved until you close the window.
• Copy the response as markdown.
• I also added a sweet tiny "Thinking..." animation haha.
• 

📦 3. The Writing Tools Chat Mode (when you invoke Writing Tools without selecting any text) now shows its response in a proper Chat window. So you can now have a quick chat with an LLM with one click, anywhere.

• https://github.com/user-attachments/assets/34dab06b-726d-46c2-a23f-dad7b81cd6a2

✨ 4. There's now an automatic check for updates feature, which checks for a new version by pinging [a file in this repo](https://github.com/theJayTea/WritingTools/blob/main/Windows_and_Linux/Latest_Version_for_Update_Check.txt) on the initial Writing Tools launch. It'll never annoy you with any pop-up notice or notification — just a small message on the Writing Tools pop-up itself :)

• <img width="226" alt="image" src="https://github.com/user-attachments/assets/5ff34406-1a67-4a6c-8ff0-b3a19c151180" />

✨ Upcoming features:

• Editable buttons! (you'll be able to re-arrange buttons, create your own, and edit their prompts).
• More of the feature suggestions in the Issues page.

📦 ⬆️ Update Instructions:

• Delete your old Writing Tools folder and download the new one (the config file format has changed).

📦 🐞 Known Issues

• 1. On some devices, Writing Tools may not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---
• ---
• ---
• Improved onboarding window
• Resolved GitHub page issues
• + 5 more

✨ Upcoming features:

• Complete context menu implementation
• UI improvements
• A few remaining Windows v6 features

📦 1. Improvements to the Summary/Key Points/Table/Chat window — you can now:

• Chat with the summary! You can for more details on particular parts, or ask it to explain things. The chat history is preserved until you close the window.
• Copy the response as markdown.
• I also added a sweet tiny "Thinking..." animation haha.
• 

📦 3. The Writing Tools Chat Mode (when you invoke Writing Tools without selecting any text) now shows its response in a proper Chat window. So you can now have a quick chat with an LLM with one click, anywhere.

• https://github.com/user-attachments/assets/34dab06b-726d-46c2-a23f-dad7b81cd6a2

✨ 4. There's now an automatic check for updates feature, which checks for a new version by pinging [a file in this repo](https://github.com/theJayTea/WritingTools/blob/main/Windows_and_Linux/Latest_Version_for_Update_Check.txt) on the initial Writing Tools launch. It'll never annoy you with any pop-up notice or notification — just a small message on the Writing Tools pop-up itself :)

• <img width="226" alt="image" src="https://github.com/user-attachments/assets/5ff34406-1a67-4a6c-8ff0-b3a19c151180" />

✨ Upcoming features:

• Editable buttons! (you'll be able to re-arrange buttons, create your own, and edit their prompts).
• More of the feature suggestions in the Issues page.

📦 ⬆️ Update Instructions:

• Delete your old Writing Tools folder and download the new one (the config file format has changed).

📦 🐞 Known Issues

• 1. On some devices, Writing Tools may not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---
• ---
• ---
• Better UI
• Improved Menu Bar integration
• + 4 more

✨ Upcoming features:

• 1. Chat mode with follow-up questions
• 2. Editable buttons!

📦 1. Summarise, Key Points, and Table now have their own pop-up UI with Markdown rendering!

• <img width="649" alt="image" src="https://github.com/user-attachments/assets/17829b76-c2d1-466f-aef5-edf69857d33a">
• <img width="714" alt="image" src="https://github.com/user-attachments/assets/3766aaa5-c14d-4975-b956-d58e69449baf">

✨ 2. [Gemini 1.5 Flash has been down for the last few days](https://discuss.ai.google.dev/t/partially-solved-gemini-models-overloading-with-token-windows-of-less-than-20/49579/5). I've swapped the model to Gemini 1.5 Flash 8B (which works), and also added a drop-down to switch between the different Gemini models.

• 

📦 3. The rounded corners are now prettier and anti-aliased, thanks to @raghavdhingra24

• <img width="96" alt="image" src="https://github.com/user-attachments/assets/5fa216e2-522b-4f75-a82c-0a81bc0c2e85">

📦 ⬆️ Update Instructions:

• Delete your old Writing Tools folder and download the new one (the config file format has changed).

📦 🐞 Known Issues

• 1. (Potential fix being investigated) On some devices, Writing Tools does not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---
• Better UI
• Improved Menu Bar integration
• Better response window positioning
• Input window when no text is selected
• + 2 more

📦 1. Summarise, Key Points, and Table now have their own pop-up UI with Markdown rendering!

• <img width="649" alt="image" src="https://github.com/user-attachments/assets/17829b76-c2d1-466f-aef5-edf69857d33a">
• <img width="714" alt="image" src="https://github.com/user-attachments/assets/3766aaa5-c14d-4975-b956-d58e69449baf">

✨ 2. [Gemini 1.5 Flash has been down for the last few days](https://discuss.ai.google.dev/t/partially-solved-gemini-models-overloading-with-token-windows-of-less-than-20/49579/5). I've swapped the model to Gemini 1.5 Flash 8B (which works), and also added a drop-down to switch between the different Gemini models.

• 

📦 3. The rounded corners are now prettier and anti-aliased, thanks to @raghavdhingra24

• <img width="96" alt="image" src="https://github.com/user-attachments/assets/5fa216e2-522b-4f75-a82c-0a81bc0c2e85">

📦 ⬆️ Update Instructions:

• Delete your old Writing Tools folder and download the new one (the config file format has changed).

📦 🐞 Known Issues

• 1. (Potential fix being investigated) On some devices, Writing Tools does not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---

✨ 🎉 Working Features

• All of the tools, including the new response windows and the manual chat option.
• Gemini and OpenAI support.
• Initial Setup, Settings, and About pages.
• 🆕 The Gradient Theme (Dark Mode and Light Mode are supported).
• 🆕 Local LLM support.

📦 ⏳ Not Yet Available

• Opening the input window when no text is selected.
• More refined positioning logic for the popup window to follow the cursor correctly.
• *Note: macOS 14 (Sonoma) or later is required to run Writing Tools (due to accessibility API requirements).*

📦 **This is super useful to select all text on a website (ctrl+a) and get a summary that's super legible and formatted, with an extensively optimised system prompt for this purpose.**

• <img width="649" alt="image" src="https://github.com/user-attachments/assets/17829b76-c2d1-466f-aef5-edf69857d33a">

📦 **Tables can now be copied into MS Word :)**

• <img width="714" alt="image" src="https://github.com/user-attachments/assets/3766aaa5-c14d-4975-b956-d58e69449baf">

✨ 2. [Gemini 1.5 Flash has been down for the last few days](https://discuss.ai.google.dev/t/partially-solved-gemini-models-overloading-with-token-windows-of-less-than-20/49579/5). I've swapped the model to Gemini 1.5 Flash 8B (which works), and also added a drop-down to switch between the different Gemini models.

• 

📦 3. The rounded corners are now prettier and anti-aliased, thanks to @raghavdhingra24

• <img width="96" alt="image" src="https://github.com/user-attachments/assets/5fa216e2-522b-4f75-a82c-0a81bc0c2e85">

📦 ⬆️ Update Instructions:

• Delete your old Writing Tools folder and download the new one (the config file format has changed).

📦 🐞 Known Issues

• 1. (Potential fix being investigated) On some devices, Writing Tools does not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.
• ---

✨ Working Features

• All of the tools, including the new response windows and the manual chat option.
• Gemini and OpenAI Support.
• Initial Setup, Settings, and About pages.

📦 Not Yet Available

• ~~Local LLM Integration.~~
• The Gradient Theme (Dark Mode and Light Mode are supported).
• Opening the Input Window when no text is selected
• More refined positioning logic for the popup window to follow the cursor correctly.
• *Note: macOS 14 (Sonoma) or above is required to run Writing Tools (due to accessibility API requirements).*

📦 Thanks again to @momokrono's amazing work with the Linux port and keyboard library migration — they did a remarkable job :)

• ---

📦 ⬆️ Update Instructions:

• Simply replace your old Writing Tools folder with the new one!

📦 🐞 Known Issues

• 1. (Potential fix being investigated) On some devices, Writing Tools does not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usually unused.

♻️ 1. 🎉 Writing Tools now supports local & other cloud LLMs! This is thanks to a huge refactor by @CameronRedmore 💛

• It can now work with ANY OpenAI-Compatible API, giving you access to:
• Locally hosted LLMs (via Ollama, llama.cpp, KoboldCPP, TabbyAPI, vLLM, etc.)
• Other cloud LLMs that have OpenAI-compatible APIs (ChatGPT, Mistral AI, Anthropic, etc.)
• This is exciting stuff!
• The existing onboarding flow with the Gemini API is still an option, giving you easy access to a free cloud model that's still extremely intelligent.

✨ 2. 💬 There's a new chat mode when you invoke writing tools with no text selected!

• (Credit: @CameronRedmore and @theJayTea )
• <img width="347" alt="image" src="https://github.com/user-attachments/assets/4c71acb1-0a27-41ea-b036-b929ca3422ce">

📦 This wouldn't be possible without @CameronRedmore's extensive work — thank you, truly, for being such an amazing contributor!

• ---

📦 ⬆️ Update Instructions:

• Delete and re-download Writing Tools, as the config file format has changed.

📦 🐞 Known Issues

• 1. (Potential fix being investigated) On some devices, Writing Tools does not work correctly with the default hotkey.
• To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools.
• PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usualy unused.
• 2. (Fix almost ready!) If you lock and unlock your PC, Writing Tools may not be able to detect your hotkey unless you relaunch it.
• 3. (Fix almost ready!) Writing Tools may not work in Microsoft Word.

📦 This is a pretty major update! :D

• 🌟 You can now choose between a Blurry Gradient Theme and Plain Theme that's similar to the native Windows + V pop-up! (Credit to [Disneyhockey40](https://github.com/Disneyhockey40) for the plain theme)
• 🌟 Implemented full Dark Mode support for both themes (Credit: [Disneyhockey40](https://github.com/Disneyhockey40) for the plain theme)
• Popup window now auto-dismisses if you click away from it!
• Enhanced onboarding process with clearer UI and smoother flow
• Various minor UI improvements (Credit: [Disneyhockey40](https://github.com/Disneyhockey40) and I)
• `About` window:
• Added "Check for updates" button
• Added contributor credit
• + 5 more

📦 ~~A Note on Antivirus Detections~~

• ~~It turns out that some antivirus providers flag the compiled exe below as malware.~~
• ~~`Trojan[Packed]/Python.Nuitka`~~
• ~~The Python to exe compiler I used is Nuitka, which is why it's getting flagged — it's a known issue.~~
• ~~It happens to obfuscate/minify the exe (to make it optimized and small as it works with its C compiler), making it look suspicious.~~
• ~~So if you'd like, you could easily run it directly from `main.py` with the instructions in the main page :)~~
• ~~If you're interested, feel free to explore the source code file yourself; it's well-documented. Writing Tools also never requires elevation ("Run as administrator").~~