{"id":28454682,"url":"https://github.com/omkarcloud/botasaurus-desktop-tutorial","last_synced_at":"2025-07-21T09:03:43.817Z","repository":{"id":280218644,"uuid":"937615534","full_name":"omkarcloud/botasaurus-desktop-tutorial","owner":"omkarcloud","description":"Step-by-step guide for building powerful desktop extractors for web scraping and data extraction.","archived":false,"fork":false,"pushed_at":"2025-05-13T05:29:54.000Z","size":1137,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-07-19T11:57:00.215Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/omkarcloud/botasaurus-desktop-tutorial","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/omkarcloud.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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},"funding":{"github":["Chetan11-Dev"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2025-02-23T13:58:37.000Z","updated_at":"2025-05-13T05:29:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"ae53940a-89ce-4f87-8916-1059d1ea27d7","html_url":"https://github.com/omkarcloud/botasaurus-desktop-tutorial","commit_stats":null,"previous_names":["omkarcloud/botasaurus-desktop-tutorial"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/omkarcloud/botasaurus-desktop-tutorial","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omkarcloud%2Fbotasaurus-desktop-tutorial","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omkarcloud%2Fbotasaurus-desktop-tutorial/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omkarcloud%2Fbotasaurus-desktop-tutorial/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omkarcloud%2Fbotasaurus-desktop-tutorial/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/omkarcloud","download_url":"https://codeload.github.com/omkarcloud/botasaurus-desktop-tutorial/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omkarcloud%2Fbotasaurus-desktop-tutorial/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266270387,"owners_count":23902731,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":"2025-06-06T20:15:45.363Z","updated_at":"2025-07-21T09:03:43.809Z","avatar_url":"https://github.com/omkarcloud.png","language":"TypeScript","funding_links":["https://github.com/sponsors/Chetan11-Dev"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/omkarcloud/botasaurus/master/images/mascot.png\" alt=\"botasaurus\" /\u003e\n\u003c/p\u003e\n  \u003cdiv align=\"center\" style=\"margin-top: 0;\"\u003e\n  \u003ch1\u003e✨ Botasaurus Desktop Tutorial ✨\u003c/h1\u003e\n\u003c/div\u003e\n\u003cem\u003e\n  \u003ch5 align=\"center\"\u003e(Programming Language - TypeScript)\u003c/h5\u003e\n\u003c/em\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/omkarcloud/botasaurus-desktop-tutorial/fork\"\u003e\n    \u003cimg alt=\"botasaurus-desktop-tutorial forks\" src=\"https://img.shields.io/github/forks/omkarcloud/botasaurus-desktop-tutorial?style=for-the-badge\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/omkarcloud/botasaurus-desktop-tutorial/stargazers\"\u003e\n    \u003cimg alt=\"Repo stars\" src=\"https://img.shields.io/github/stars/omkarcloud/botasaurus-desktop-tutorial?style=for-the-badge\u0026color=yellow\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/omkarcloud/botasaurus-desktop-tutorial/blob/master/LICENSE\"\u003e\n    \u003cimg alt=\"botasaurus-desktop-tutorial License\" src=\"https://img.shields.io/github/license/omkarcloud/botasaurus-desktop-tutorial?color=orange\u0026style=for-the-badge\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/omkarcloud/botasaurus-desktop-tutorial/issues\"\u003e\n    \u003cimg alt=\"issues\" src=\"https://img.shields.io/github/issues/omkarcloud/botasaurus-desktop-tutorial?color=purple\u0026style=for-the-badge\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://views.whatilearened.today/views/github/omkarcloud/botasaurus-desktop-tutorial.svg\" width=\"80px\" height=\"28px\" alt=\"View\" /\u003e\n\u003c/p\u003e\n\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://gitpod.io/#https://github.com/omkarcloud/botasaurus-desktop-starter\"\u003e\n    \u003cimg alt=\"Open in Gitpod\" src=\"https://gitpod.io/button/open-in-gitpod.svg\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\n# Botasaurus Desktop Tutorial\n\nThis repository contains the final code for the **Botasaurus Desktop Tutorial**.  It contains the 2 extractors:\n\n\n1. **Yahoo Finance Stock Scraper**\n   This tool scrapes real-time stock prices from Yahoo Finance, demonstrating how you can use web scraping tools like Playwright in a desktop app.\n\n   ![Stock Scraper Demo](https://raw.githubusercontent.com/omkarcloud/botasaurus/master/images/stock-scraper-preview.gif)\n\n2. **Amazon Invoice PDF Extractor**\n   This tool automates the extraction of key invoice data from Amazon PDF invoices, saving hours of manual work for accountants. It extracts the following information:\n   - Document Number\n   - Document Date\n   - Place of Supply\n   - GST Identification Number\n\n   ![PDF Extraction Demo](https://raw.githubusercontent.com/omkarcloud/botasaurus/master/images/pdf-extract-preview.gif)\n\n\n## 🚀 Project Setup\n\nTo run locally, follow these steps:  \n\n1️⃣ Clone the Magic 🧙‍♀️:\n   ```bash\n   git clone https://github.com/omkarcloud/botasaurus-desktop-tutorial my-botasaurus-desktop-app\n   cd my-botasaurus-desktop-app\n   ```\n\n2️⃣ Install Packages 📦:\n   ```bash\n   npm install\n   ```\n\n3️⃣ Launch the App 🚀:\n   ```bash\n   npm run dev\n   ```\n\nThis will launch your **Botasaurus** desktop application in development mode.  \n\n\n## 💡 Learn to Develop Scraping Apps\n\nTo understand how to develop desktop apps using **Botasaurus**, please refer to the [Botasaurus Desktop Documentation](https://github.com/omkarcloud/botasaurus/blob/master/botasaurus-desktop-tutorial.md).\n\n\n## 📦 Create Installers for Your OS\n\nTo create an installer for your operating system, run the following command:\n```bash\nnpm run package\n```\n\nAfter executing the command, you can find the installer for your OS in the `release/build` folder.\n\n![Screenshot of release/build folder with OS-specific installer](https://raw.githubusercontent.com/omkarcloud/botasaurus/master/images/installer-build-folder.png)\n\n**Note**  \nOn Windows, if you face the \"resource busy or locked\" error:\n\n![Resource Busy](https://raw.githubusercontent.com/omkarcloud/botasaurus/master/images/resource-busy.png)  \n\nPlease follow these steps to resolve the issue:\n1. Run the Command Prompt as an administrator.\n2. Use the 'cd' command to navigate to your project directory.\n3. Run the command `npm run package` again to create the installer.\n\nThis will resolve the error and allow the installer to be created successfully.\n\n## 📦 Creating Installers for All Operating Systems (Recommended Method)\n\nTo automatically create installers for all operating systems whenever you push changes to GitHub, you can set up GitHub Actions. For step-by-step instructions, please follow the guide [here](https://github.com/omkarcloud/botasaurus/blob/master/botasaurus-desktop-tutorial.md#how-do-i-create-installers-for-multiple-platforms). \n\nThis is the recommended method for creating installers.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fomkarcloud%2Fbotasaurus-desktop-tutorial","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fomkarcloud%2Fbotasaurus-desktop-tutorial","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fomkarcloud%2Fbotasaurus-desktop-tutorial/lists"}