{"id":26178475,"url":"https://github.com/houshmand-2005/tabtrove","last_synced_at":"2025-09-01T13:33:12.183Z","repository":{"id":194777679,"uuid":"691561206","full_name":"houshmand-2005/TabTrove","owner":"houshmand-2005","description":"A Browser Collection Manager","archived":false,"fork":false,"pushed_at":"2023-09-16T13:28:44.000Z","size":4205,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"houshmand","last_synced_at":"2023-09-16T22:53:20.949Z","etag":null,"topics":["browser","firefox","lz4"],"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/houshmand-2005.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}},"created_at":"2023-09-14T12:35:10.000Z","updated_at":"2023-09-15T10:43:03.000Z","dependencies_parsed_at":"2023-09-15T04:22:03.081Z","dependency_job_id":null,"html_url":"https://github.com/houshmand-2005/TabTrove","commit_stats":null,"previous_names":["houshmand-2005/tabtrove"],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/houshmand-2005%2FTabTrove","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/houshmand-2005%2FTabTrove/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/houshmand-2005%2FTabTrove/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/houshmand-2005%2FTabTrove/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/houshmand-2005","download_url":"https://codeload.github.com/houshmand-2005/TabTrove/tar.gz/refs/heads/houshmand","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243114719,"owners_count":20238648,"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":["browser","firefox","lz4"],"created_at":"2025-03-11T21:28:47.631Z","updated_at":"2025-03-11T21:28:48.492Z","avatar_url":"https://github.com/houshmand-2005.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n      \u003cimg width=\"140\" height=\"140\" src=\"readme_files/logo.jpg\"\u003e\n\u003c/p\u003e\n\u003ch1 align=\"center\"/\u003eTabTrove\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n    A Browser Collection Manager\n\u003c/p\u003e\n\u003chr/\u003e\n\n**Table of Contents**\n\n- [Description](#description)\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Configuration](#configuration)\n- [Browsers Notes](#browsers-notes)\n- [Supported Browsers](#supported-browsers)\n\n## Description\n\nTabTrove is a Browser Collection Manager that allows you to manage collections of browser tabs and open them in your preferred web browser. You can create, organize, and open collections of URLs, making it easy to access your favorite websites or work-related tabs with just a few clicks.\n\n## Requirements\n\nTo use this program, you need the following:\n\n- Python 3.10+\n- Python packages: `lz4`, `rich`\n\n## Installation\n\n1. Clone this repository to your local machine:\n\n   ```shell\n   git clone https://github.com/houshmand-2005/TabTrove.git\n   ```\n\n2. Navigate to the project directory:\n\n   ```shell\n   cd TabTrove\n   ```\n\n3. Install the required Python packages using pip:\n\n   ```shell\n   pip install lz4 rich\n   ```\n\n## Usage\n\nYou can run the program by executing the `tabtrove.py` script. It provides a menu-based interface with the following options:\n\n1. **Open a Collection:** Open a previously created collection of URLs in your web browser.\n2. **Add a Collection:** Create a new collection of URLs.\n3. **Delete a Collection:** Delete selected collection.\n\nFollow the on-screen prompts to use the program effectively.\n\n## Configuration\n\nThe program uses a `config.json` file to store browser and collection information. You can configure your browser paths and manage collections through this file. Here's an example of the `config.json` structure:\n\n```json\n{\n  \"browsers\": {\n    \"firefox\": {\n      \"excitable_path\": \"\",\n      \"profile_path\": \"\"\n    },\n    \"edge\": {\n      \"excitable_path\": \"\"\n    }\n  },\n  \"collections\": {}\n}\n```\n\n- `browsers`: Configure your preferred web browsers, specifying the executable paths and profile paths \u003csub\u003e(to read your open tabs)\u003c/sub\u003e.\n- `collections`: Manage your collections of URLs within this section.\n\n**Note**: Be careful when editing the `config.json` file, read [here](#browsers-notes) for more details\n\n## Browsers Notes\n\nif you don't know where is your browser profile path you can read this:\n\nwindows:\n\n```shell\nC:\\Users\\\u003cusername\u003e\\AppData\\Roaming\\Mozilla\\Firefox\\Profiles\\xxxxxxxx.default\n```\n\nlinux:\n\n```shell\n/home/\u003cusername\u003e/.mozilla/firefox/xxxxxxxx.default\n```\n\n## Supported Browsers\n\nThere is no limit to open tabs in other browsers, and you can add the executable file of your favorite browser to the [config](#configuration) and open tabs inside it.\nBut for reading open tabs and saving them, only **Firefox** browser is currently supported.\n\u003cbr\u003e\nOther browsers don't make their session files easily available and sometimes they encrypt them, so it takes a lot of time to support the rest of the browsers.\n\n\u003chr\u003e\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"readme_files/tabtrove.gif\" width=\"710\" height=\"380\"/\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhoushmand-2005%2Ftabtrove","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhoushmand-2005%2Ftabtrove","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhoushmand-2005%2Ftabtrove/lists"}