{"id":41595079,"url":"https://github.com/simplecyber/woodls","last_synced_at":"2026-04-18T12:08:04.861Z","repository":{"id":334358631,"uuid":"1098311055","full_name":"SimpleCyber/Woodls","owner":"SimpleCyber","description":"Auto sormated typing","archived":false,"fork":false,"pushed_at":"2026-02-16T15:56:51.000Z","size":207970,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-16T21:24:03.025Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://woodls.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SimpleCyber.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-17T14:27:10.000Z","updated_at":"2026-02-16T15:56:55.000Z","dependencies_parsed_at":"2026-02-11T10:01:41.469Z","dependency_job_id":null,"html_url":"https://github.com/SimpleCyber/Woodls","commit_stats":null,"previous_names":["simplecyber/woodls"],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/SimpleCyber/Woodls","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimpleCyber%2FWoodls","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimpleCyber%2FWoodls/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimpleCyber%2FWoodls/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimpleCyber%2FWoodls/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SimpleCyber","download_url":"https://codeload.github.com/SimpleCyber/Woodls/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimpleCyber%2FWoodls/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29662591,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-20T19:49:36.704Z","status":"ssl_error","status_checked_at":"2026-02-20T19:44:05.372Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-24T10:00:17.315Z","updated_at":"2026-04-18T12:08:04.851Z","avatar_url":"https://github.com/SimpleCyber.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"webp/woodls.png\" width=\"40\" height=\"40\" alt=\"Woodls Logo\" style=\"vertical-align: middle;\"\u003e Woodls\n\n**Woodls** is an intelligent AI-powered voice typing assistant designed to streamline your workflow. By combining global hotkeys with Google's advanced Gemini AI, Woodls captures your speech, refines it for perfect grammar and punctuation, and types it directly into any active application.\n\n\u003cimg width=\"1500\" height=\"940\" alt=\"Screenshot 2026-02-16 144603\" src=\"https://github.com/user-attachments/assets/d92f31e0-34f6-4ab5-bf58-63172dc60ad0\" /\u003e\n\n## 🚀 Features\n\n- **Global Hotkey Activation**: Press a custom hotkey anywhere on your system to start recording instantly.\n- **AI-Powered Transcription**: Uses Google's **Gemini Flash** model for fast and accurate speech-to-text.\n- **Smart Refinement**: Automatically fixes grammar, punctuation, and removes filler words (like \"ums\" and \"ahs\").\n- **Auto-Type \u0026 Instant Paste**: Can simulate typing or paste text directly into your active window (Word, browser, code editor, etc.).\n- **Built-in Notes**: A dedicated Notes tab to capture thoughts and ideas using your voice.\n- **History Tracking**: Keeps a local history of all your transcriptions with audio playback.\n- **Minimalist Overlay**: A non-intrusive floating overlay shows recording status and volume levels.\n- **Privacy-Focused**: Audio recordings and history are stored locally on your machine.\n- **Background Mode**: Runs quietly in the system tray.\n\n## 🛠️ Installation\n\n\u003e [!IMPORTANT]\n\u003e **Windows SmartScreen Notice**: Since Woodls is currently an unsigned application, Windows may show a \"Windows protected your PC\" warning during installation.\n\u003e To proceed: Click **\"More info\"** and then select **\"Run anyway\"**.\n\n### Prerequisites\n\n- [Node.js](https://nodejs.org/) (v16 or higher)\n- A Google Gemini API Key (Get one from [Google AI Studio](https://aistudio.google.com/))\n\n### Steps\n\n1. **Clone the repository**\n\n   ```bash\n   git clone https://github.com/SimpleCyber/Woodls.git\n   cd woodls\n   ```\n\n2. **Install dependencies**\n\n   ```bash\n   npm install\n   ```\n\n3. **Configure Environment**\n   Create a `.env` file in the root directory:\n\n   ```env\n   GEN_AI_API_KEY=your_gemini_api_key_here\n   GEN_AI_MODEL=gemini-2.5-flash-lite\n   ```\n\n4. **Run the App**\n   ```bash\n   npm start\n   ```\n\n## 📖 Usage\n\n1. **Set your Hotkey**: On the Home screen, click \"Set Hotkey\" and press your desired key combination (e.g., `F1` or `Ctrl+Space`).\n2. **Start Dictating**: Press the hotkey. The overlay will appear. Speak clearly.\n3. **Stop \u0026 Transcribe**: Release the hotkey (or press again depending on mode). Woodls will process your audio.\n4. **Auto-Type**: The transcribed and refined text will be automatically typed into your currently active window.\n\n## ⚙️ Settings\n\n- **Use Backspace**: If enabled, sends a Backspace key before typing to remove any accidental characters typed during hotkey press.\n- **Instant Paste**: Uses Clipboard + Paste (Ctrl+V) for faster text insertion instead of simulating keystrokes.\n- **AI Enhanced**: Toggles the grammar and punctuation refinement step.\n- **Run on Startup**: Launch Woodls automatically when you log in.\n- **Start Hidden**: Launch minimized to the system tray.\n\n## 🔧 Tech Stack\n\n- **Electron**: Cross-platform desktop framework.\n- **Google Gemini API**: Generative AI for transcription and text refinement.\n- **Firebase Auth**: User authentication.\n- **RobotJS**: System-level keyboard simulation.\n- **Node Global Key Listener**: standardized global hotkey handling.\n\n## 📄 License\n\nThis project is licensed under the ISC License.\n\n\u003c!-- Build releases command --\u003e\n\ngit tag -d v2.9.4\ngit tag v2.9.4\ngit push origin v2.9.4 --force\n\n---\n\nsteps to follow for the new releases\n\n1. update the version in package.json\n2. commit the changes\n3. \u003c!-- Build releases command --\u003e\n\n   git tag -d v2.9.4\n   git tag v2.9.4\n   git push origin v2.9.4 --force\n\n4. now update the relsease -\u003e draft to publish changes\n5. Great Good to go now users will see the update info\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimplecyber%2Fwoodls","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimplecyber%2Fwoodls","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimplecyber%2Fwoodls/lists"}