{"id":15323687,"url":"https://github.com/mvrilo/s","last_synced_at":"2025-10-09T10:31:24.647Z","repository":{"id":57587833,"uuid":"51561996","full_name":"mvrilo/s","owner":"mvrilo","description":"Open a web search in your terminal.","archived":false,"fork":true,"pushed_at":"2016-02-12T02:08:34.000Z","size":1965,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-26T19:02:15.074Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"zquestz/s","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mvrilo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-02-12T02:08:09.000Z","updated_at":"2016-02-12T02:08:09.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mvrilo/s","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/mvrilo/s","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvrilo%2Fs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvrilo%2Fs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvrilo%2Fs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvrilo%2Fs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mvrilo","download_url":"https://codeload.github.com/mvrilo/s/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvrilo%2Fs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001275,"owners_count":26083040,"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","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":"2024-10-01T09:21:02.945Z","updated_at":"2025-10-09T10:31:24.182Z","avatar_url":"https://github.com/mvrilo.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![License][License-Image]][License-Url] [![ReportCard][ReportCard-Image]][ReportCard-Url] [![Build][Build-Status-Image]][Build-Status-Url] [![Release][Release-Image]][Release-Url]\n# s\nWeb search from the terminal. Just opens in your browser.\n\n```\nUsage:\n  s \u003cquery\u003e [flags]\n\nFlags:\n  -b, --binary string     binary to launch search URI\n  -c, --cert string       path to cert.pem for TLS\n  -k, --key string        path to key.pem for TLS\n  -l, --list-providers    list supported providers\n      --port int          server port (default 8080)\n  -p, --provider string   set search provider (default \"google\")\n  -s, --server            launch web server\n  -v, --verbose           display URL when opening\n      --version           display version\n```\n\n## Install\n\n```\ngo get -v github.com/zquestz/s\ncd $GOPATH/src/github.com/zquestz/s\nmake\nmake install\n```\n\n## Examples\n\nSearch for puppies on google.\n```\ns puppies\n```\n\nSearch for a wifi router on amazon\n```\ns -p amazon wifi router\n```\n\nSearch for rhinos on wikipedia\n```\ns -p wikipedia rhinos\n```\n\n## Provider Expansion\n\nWe can do partial matching of provider names. This searches Facebook for hamsters.\n```\ns -p fa hamsters\n```\n\nOr toasters on amazon.\n```\ns -p am toasters\n```\n\n## Provider Autocompletion\n\nAutocompletion for providers is supported. For setting up autocompletion:\n\n1. Have `s` installed\n2. Add the following lines to `~/.bash_profile` or `~/.zshrc`\n```\nif [ -f $GOPATH/src/github.com/zquestz/s/autocomplete/s-completion.bash ]; then\n    . $GOPATH/src/github.com/zquestz/s/autocomplete/s-completion.bash\nfi\n```\n\nNow you are good to go.\n```\ns -p ba\u003cTAB\u003e\u003cTAB\u003e\nbaidu     bandcamp\n```\n\n## Advanced\n\nSetup an alias in your `.profile` for your favorite providers.\n```\nalias sa=\"s -p amazon\"\nalias sw=\"s -p wikipedia\"\n```\n\nUse w3m to find cats instead of just your default browser.\n```\ns -b w3m cats\n```\n\nSearch for conspiracy theories in incognito mode.\n```\ns -b \"chromium --incognito\" conspiracy theories\ns -b \"firefox --private-window\" conspiracy theories\n```\n\nSearch in a specific subreddit.\n```\ns -p reddit /r/cscareerquestions best startups.\n```\n\n## Server Mode\n\nA web interface is also provided. Just pass the `-s` flag.\n\nStart a server on port 8080 (default).\n```\ns -s\n```\n\nStart a server with TLS on port 8443.\n```\ns -s -c /path/to/cert.pem -k /path/to/key.pem --port 8443\n```\n\n## Supported Providers\n\n* 500px\n* 8tracks\n* amazon\n* arstechnica\n* arxiv\n* atmospherejs\n* baidu\n* bandcamp\n* bing\n* codepen\n* coursera\n* cplusplus\n* crunchyroll\n* digg\n* diigo\n* dockerhub\n* dribbble\n* duckduckgo\n* dumpert\n* facebook\n* flickr\n* flipkart\n* foursquare\n* gist\n* github\n* gmail\n* go\n* godoc\n* google\n* googleplus\n* hackernews\n* ietf\n* ifttt\n* imdb\n* imgur\n* inbox\n* instagram\n* kickasstorrents\n* libgen\n* linkedin\n* lmgtfy\n* macports\n* mdn\n* msdn\n* naver\n* netflix\n* nhaccuatui\n* npm\n* npmsearch\n* nvd\n* overstock\n* packagist\n* php\n* pinterest\n* python\n* quora\n* reddit\n* rottentomatoes\n* rubygems\n* soundcloud\n* spotify\n* stackoverflow\n* steam\n* taobao\n* thepiratebay\n* torrentz\n* twitchtv\n* twitter\n* unity3d\n* upcloud\n* vimeo\n* wikipedia\n* wolframalpha\n* yahoo\n* yandex\n* youtube\n\n#### Contributors\n\n* [Josh Ellithorpe (zquestz)](https://github.com/zquestz/)\n* [Christian Petersen (fnky)](https://github.com/fnky/)\n* [Preet Bhinder (mbhinder)](https://github.com/mbhinder/)\n* [Robert-Jan Keizer (KeizerDev)](https://github.com/KeizerDev/)\n* [Vitor Cortez (vekat)](https://github.com/vekat/)\n* [David Liu (tw4dl)](https://github.com/tw4dl/)\n* [Lex Broner (akb)](http://github.com/akb/)\n* [Diego Jara (djap96)](https://github.com/djap96/)\n* [Luvsandondov Lkhamsuren (lkhamsurenl)](https://github.com/lkhamsurenl/)\n* [Eray Aydın (erayaydin)](https://github.com/erayaydin/)\n* [Murilo Santana (mvrilo)](https://github.com/mvrilo/)\n\n#### License\n\ns is released under the MIT license.\n\n[License-Url]: http://opensource.org/licenses/MIT\n[License-Image]: https://img.shields.io/npm/l/express.svg\n[ReportCard-Url]: http://goreportcard.com/report/zquestz/s\n[ReportCard-Image]: http://goreportcard.com/badge/zquestz/s\n[Build-Status-Url]: http://travis-ci.org/zquestz/s\n[Build-Status-Image]: https://travis-ci.org/zquestz/s.svg?branch=master\n[Release-Url]: https://github.com/zquestz/s/releases/tag/v0.3.1\n[Release-image]: http://img.shields.io/badge/release-v0.3.1-1eb0fc.svg\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmvrilo%2Fs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmvrilo%2Fs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmvrilo%2Fs/lists"}