{"id":17021888,"url":"https://github.com/bonnie39/voyage","last_synced_at":"2025-04-12T10:14:25.172Z","repository":{"id":198966753,"uuid":"701894848","full_name":"Bonnie39/voyage","owner":"Bonnie39","description":"Simple frontend for Google Custom Search Engine","archived":false,"fork":false,"pushed_at":"2024-04-17T14:22:23.000Z","size":1162,"stargazers_count":10,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-12T10:14:14.161Z","etag":null,"topics":["free","google","google-api","google-api-client","google-custom-search","google-custom-search-api","google-custom-search-engine","google-programmable-search-engine","html","html-css-javascript","javascript","open-source","search","search-engine","self-hosted","voyage","voyage-search-engine","web","web-design","website"],"latest_commit_sha":null,"homepage":"https://bonnie39.github.io/tools/voyage","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Bonnie39.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2023-10-07T22:06:44.000Z","updated_at":"2024-09-30T05:25:42.000Z","dependencies_parsed_at":null,"dependency_job_id":"6695d210-1cd0-419e-831f-f5d41b1891e4","html_url":"https://github.com/Bonnie39/voyage","commit_stats":null,"previous_names":["bonnie39/voyage"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bonnie39%2Fvoyage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bonnie39%2Fvoyage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bonnie39%2Fvoyage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bonnie39%2Fvoyage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Bonnie39","download_url":"https://codeload.github.com/Bonnie39/voyage/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248550632,"owners_count":21122934,"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":["free","google","google-api","google-api-client","google-custom-search","google-custom-search-api","google-custom-search-engine","google-programmable-search-engine","html","html-css-javascript","javascript","open-source","search","search-engine","self-hosted","voyage","voyage-search-engine","web","web-design","website"],"created_at":"2024-10-14T07:08:46.379Z","updated_at":"2025-04-12T10:14:25.149Z","avatar_url":"https://github.com/Bonnie39.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://bonnie39.github.io/img/bdev-makeshift-img-cdn/voyage-logo.webp\" width=\"96\" /\u003e\n\n# Voyage\n\nSimple self-hosted frontend for Google Custom Search Engine.\n\n\u003cdiv style=\"text-align:center\" align=\"center\"\u003e\n    \u003cimg src=\"https://bonnie39.github.io/img/bdev-makeshift-img-cdn/voyage-preview.webp\" width=\"720\" /\u003e\n\u003c/div\u003e\n\n### Why use this?\n\nWhile this engine does use Google's API to perform searches, you aren't directly connecting to google.com which means none of Google's analytics and tracking is running in the background as you search. They do still collect some data on your API usage, though it's minimal compared to using their proprietary search engine. **ALSO** You don't get any of the spammy \"promoted\" or advertisement links that usually appear at the top of the search page. Using a custom frontend for Google's search API gives you ONLY the results you need.\n\nPrerequisites:\n\n## 1: Google Custom Search Engine \u0026 CSE ID\n\n\u003ca href=\"https://programmablesearchengine.google.com/controlpanel/create\" target=\"_blank\"\u003eCreate a new Programmable Search Engine.\u003c/a\u003e\nFeel free to name your engine whatever you want. Ensure that you choose \"search the entire web\" for what to search and enable Image Search functionality.\nOnce your engine has been created, click \"customize\" and then copy your Search Engine ID.\n\n## 2: Create a project in Google Cloud\nGo to \u003ca href=\"https://console.cloud.google.com/\" target=\"_blank\"\u003econsole.cloud.google.com\u003c/a\u003e and create a new project. Again, you can name it whatever you want but matching your Custom/Programmable Search Engine's name would make organization easier. Select your newly created project once it is finished.\n\n## 3: Google Custom Search JSON API Key\n\nHead to \u003ca href=\"https://developers.google.com/custom-search/v1/introduction\" target=\"_blank\"\u003edevelopers.google.com\u003c/a\u003e and scroll down to where it says \"Identify your application to Google with API key\" and click the blue \"Get a key\" button next to \"Programmable Search Engine (free edition) users.\" Choose your project you created on Google Cloud and when the option shows up, click \"Show Key\" and copy this as well.\n\n### Now you can set up Voyage!\n\n#### **IMPORTANT**\nBefore using Voyage you will need to click the gear icon in the top right and choose \"Change API Key\" and enter in your JSON Api Key and CSE ID that you acquired in the previous steps. Once this has been completed, you can start searching!\n\n## Method 1: VSCode\n\nDownload the source code from this repository and extract the ZIP file's contents to where ever you wish.\nIf you don't have it already, download \u003ca href=\"https://code.visualstudio.com/\" target=\"_blank\"\u003eVisual Studio Code.\u003c/a\u003e Once you have it downloaded open it and head to the Extensions Marketplace (button on the left with 4 blocks) and search for **Live Server** by Ritwick Dey. Once that is downloaded, open any file from Voyage's source code in the editor and press the \"**Go Live**\" button on the bottom left. Note that if you close VSCode you will have to launch the live server again. If you wish to use Voyage on another device, you will need to know the IP address of the device it is hosted on. Type that IP address into the address bar followed by \":\" and the port your live server is being hosted on. By default, Live Server uses port 5500. Your address bar should look something like this: **###.###.#.#:5500**.\n\n## Method 2: Hosting Online\n\nI personally use GitHub Pages since it is free and easy. However, you can use whatever hosting service you want. Unfortunately I myself cannot provide help with this since I have no experience in using any other hosting sites and setting up a GitHub pages website is extremely easy and you can follow this official guide \u003ca href=\"https://docs.github.com/en/pages/getting-started-with-github-pages/creating-a-github-pages-site\" target=\"_blank\"\u003ehere\u003c/a\u003e.\n\n## Alternative\n\nIf you don't want to host Voyage yourself, you can use my publicly hosted instance on \u003ca href=\"https://bonnie39.github.io/tools/voyage\" target=\"_blank\"\u003emy website\u003c/a\u003e.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbonnie39%2Fvoyage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbonnie39%2Fvoyage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbonnie39%2Fvoyage/lists"}