{"id":29998912,"url":"https://github.com/pranavh-2004/termbrowse","last_synced_at":"2026-05-17T02:33:59.014Z","repository":{"id":307289526,"uuid":"1029012465","full_name":"Pranavh-2004/TermBrowse","owner":"Pranavh-2004","description":"A Terminal-Based Web Browser Lightweight, command-line web browser that supports Google search, text rendering, link navigation, bookmarking, and readability enhancements — all within your terminal.","archived":false,"fork":false,"pushed_at":"2025-07-30T11:49:21.000Z","size":9,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-30T14:14:18.443Z","etag":null,"topics":["browser","cli","internet","minimalist","search","terminal","text-browser","tool","web-browser"],"latest_commit_sha":null,"homepage":"","language":"Python","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/Pranavh-2004.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2025-07-30T11:47:39.000Z","updated_at":"2025-07-30T11:51:43.000Z","dependencies_parsed_at":"2025-07-30T14:14:46.911Z","dependency_job_id":"221f2ae3-cb7c-43a7-8aa7-77af80f1e86b","html_url":"https://github.com/Pranavh-2004/TermBrowse","commit_stats":null,"previous_names":["pranavh-2004/termbrowse"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Pranavh-2004/TermBrowse","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pranavh-2004%2FTermBrowse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pranavh-2004%2FTermBrowse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pranavh-2004%2FTermBrowse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pranavh-2004%2FTermBrowse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Pranavh-2004","download_url":"https://codeload.github.com/Pranavh-2004/TermBrowse/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pranavh-2004%2FTermBrowse/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275304913,"owners_count":25441168,"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-09-15T02:00:09.272Z","response_time":75,"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":["browser","cli","internet","minimalist","search","terminal","text-browser","tool","web-browser"],"created_at":"2025-08-05T04:29:20.571Z","updated_at":"2025-09-15T18:54:36.002Z","avatar_url":"https://github.com/Pranavh-2004.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TermBrowse\n\n**TermBrowse** is a lightweight command-line web browser designed for productivity and minimalism. It allows you to search the web, view readable text content, follow links, and manage bookmarks — all from your terminal.\n\n---\n\n## 📦 Features\n\n* 🔍 Web search using DuckDuckGo\n* 🌐 Browse simplified readable web pages\n* 🧭 Navigate history: `:back`, `:forward`\n* 🔖 Bookmark support: `:bookmark`, `:bookmarks`\n* 🔗 Follow page links with `link \u003cn\u003e` or `l \u003cn\u003e`\n* 📄 Paginated article view\n* 🌈 Highlights visited links\n\n---\n\n## 🧑‍💻 Usage\n\n### 🔧 Installation\n\n```bash\n# Clone the repository\n$ git clone https://github.com/your-username/termbrowse.git\n$ cd termbrowse\n\n# Create and activate a virtual environment\n$ python3 -m venv venv\n$ source venv/bin/activate\n\n# Install dependencies\n$ pip install -r requirements.txt\n```\n\n### 🚀 Running TermBrowse\n\n```bash\n$ python cli_browse.py\n```\n\nYou’ll be greeted with a prompt:\n\n```\n🧭 CLI Browser\nType a search query or command:\n  - :back, :forward, :bookmark, :bookmarks, :exit\n  - link \u003cn\u003e or l \u003cn\u003e to open a link on current page\n```\n\n---\n\n## 📂 Project Structure\n\n```\nTermBrowse/\n├── browser/              # Core browsing logic\n│   ├── fetch.py          # Page fetching and readability parsing\n│   ├── history.py        # Browsing history management\n│   ├── links.py          # Link utilities\n│   ├── render.py         # (optional extension)\n│   └── search.py         # DuckDuckGo search integration\n├── cli_browse.py         # Main CLI launcher\n├── cli_browse_poc.py     # Proof-of-concept legacy script\n├── data/\n│   └── bookmarks.json    # Bookmarked URLs\n├── tests/                # Unit tests\n│   ├── test_render.py\n│   └── test_search.py\n├── utils/\n│   ├── formatter.py      # Link display, text pagination, color formatting\n│   ├── bookmarks.py      # Bookmark storage and retrieval\n│   └── state.py          # Session state manager\n├── requirements.txt      # Dependencies\n├── LICENSE\n└── README.md             # You’re here!\n```\n\n---\n\n## ✅ To-Do / Roadmap\n\n* [x] Integrated readability parsing\n* [x] Paginated terminal viewer\n* [x] Bookmarks and visited link storage\n* [ ] Tabbed browsing\n* [ ] Image or media previews\n* [ ] Custom themes (light/dark)\n\n---\n\n## 🧪 Testing\n\nRun tests using:\n\n```bash\n$ python -m unittest discover tests\n```\n\n---\n\n## 🧠 Inspiration\n\n* [w3m](http://w3m.sourceforge.net/)\n* [lynx](https://lynx.invisible-island.net/)\n* [readability-lxml](https://github.com/buriy/python-readability)\n\n---\n\n## ⚖️ License\n\nMIT License. See `LICENSE` file for details.\n\n---\n\n## 👨‍🚀 Author\n\n**Pranav Hemanth** — [@pranav-hemanth](https://github.com/pranav-hemanth)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpranavh-2004%2Ftermbrowse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpranavh-2004%2Ftermbrowse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpranavh-2004%2Ftermbrowse/lists"}