<!-- trunk-ignore-all(trufflehog/GitHubOauth2) -->
<!-- trunk-ignore-all(markdownlint/MD041) -->
[](https://github.com/iloveitaly/clean-browser/releases)
[](https://pepy.tech/project/clean-workspace)
[](https://opensource.org/licenses/MIT)
[](https://python-poetry.org/)
# Clean Workspace: Archive Web Browser Tabs
I love experimenting with productivity. One glitch I've found in my mind is I can easily
get distracted by open tabs on my browser, especially if I'm trying to write or read something which I want to give
my full attention to.
I've found that if I close all my tabs (similar idea to [shrinking context size](http://mikebian.co/improve-motivation-and-focus-with-small-contexts/)), I can focus better on the task at hand. However, I don't
want to lose any interesting tabs so I don't easily quit my browsers. It's just the little extra of cognitive energy required to add more focus that doesn't get spent.
This is utility to fix this issue. It closes all your tabs (in both Safari & Chrome), sends them to [todoist](https://mikebian.co/todoist)
with a specified project and optionally a label, and outputs the list to the terminal (mostly for debugging). Only unique URLs are sent to Todoist, if you have a previous "archive task" with a URL archived it will not be archived again.
This utility has helped my mind and made it easy for me to find interesting things I've run into in the past. I've tied this into a 'first wake' [hyper focus](https://mikebian.co/hyper-focus) script to automatically run each morning when I first open my computer.
## Installation
```shell
pip install clean-workspace
```
- `TODOIST_API_KEY` has to exist in your shell environment for the tool to run.
I recommend using [direnv](https://direnv.net/) to do this. Add your todoist token to `.envrc` and `direnv allow .`
- Customize the url and domain blacklist
## Usage
```shell
clean-workspace --help
Usage: clean-workspace [OPTIONS]
Options:
--blacklist-domains PATH
--blacklist-urls PATH
--tab-description TEXT Description for tab
--todoist-label TEXT label in todoist for all created tasks [default:
web-archive]
--todoist-project TEXT project in todoist for all created tasks
[default: Learning]
--help Show this message and exit.
```
## Development
```shell
poetry install
poetry run clean-workspace
```
### Regex Entries
You can use regex matches in both the url and domain blacklist files. For example, if you want to blacklist all Zoom domains, you can use the following:
```shell
echo "/.*zoom\.us/" >> ~/.config/clean-workspace/blacklist-domains.txt
```
A regex entry starts & ends with `/`, like `sed`.
### Collecting Tab Description Via AppleScript
Here's a quick script you can use to collect a description of what you were working on via applescript:
```shell
dialogResult=$(
osascript <<EOT
set dialogResult to display dialog "What were you working on yesterday?" buttons {"OK"} default button "OK" giving up after 300 default answer ""
return text returned of dialogResult
EOT
)
```
Here's a [full example](https://github.com/iloveitaly/dotfiles/blob/648010ec9a9c8f1fb0aa70be138994689f3bbfb3/.config/focus/initial_wake.sh#L42-L53) of using this with [hyper-focus](https://www.raycast.com/iloveitaly/hyper-focus).
## Debugging
You can use `ipython` to interactively play with the todoist API:
```shell
from clean_workspace import _todoist_api_key
api = TodoistAPI(_todoist_api_key())
```
## Inspiration
- <https://gist.github.com/aleks-mariusz/cc27b21f2c5b91fbd285>
- <https://github.com/tominsam/shelf-python/blob/f357d9b147fa651034b71501edabf65f59d5befa/extractors/ComAppleSafari.py#L11>
## TODO
- [ ] Indicate in python config that this is macOS only in poetry config? I wonder if pyobjc does this in some way?
- [ ] move blacklist files into example area of repo
- [x] look at previous tasks and see if links are contained there before including them again
- [ ] support google chrome canary
- [ ] check to make sure regex gdrive urls work
Raw data
{
"_id": null,
"home_page": "https://github.com/iloveitaly/clean-browser",
"name": "clean-workspace",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "todoist, browser, productivity",
"author": "Mike Bianco",
"author_email": "mike@mikebian.co",
"download_url": "https://files.pythonhosted.org/packages/70/eb/efe8a3e2cb9d8f269d35af3508b76ecd8ff05b3e8739fe162cb1ab51345b/clean_workspace-0.7.0.tar.gz",
"platform": null,
"description": "<!-- trunk-ignore-all(trufflehog/GitHubOauth2) -->\n<!-- trunk-ignore-all(markdownlint/MD041) -->\n\n[](https://github.com/iloveitaly/clean-browser/releases)\n[](https://pepy.tech/project/clean-workspace)\n[](https://opensource.org/licenses/MIT)\n[](https://python-poetry.org/)\n\n# Clean Workspace: Archive Web Browser Tabs\n\nI love experimenting with productivity. One glitch I've found in my mind is I can easily\nget distracted by open tabs on my browser, especially if I'm trying to write or read something which I want to give\nmy full attention to.\n\nI've found that if I close all my tabs (similar idea to [shrinking context size](http://mikebian.co/improve-motivation-and-focus-with-small-contexts/)), I can focus better on the task at hand. However, I don't\nwant to lose any interesting tabs so I don't easily quit my browsers. It's just the little extra of cognitive energy required to add more focus that doesn't get spent.\n\nThis is utility to fix this issue. It closes all your tabs (in both Safari & Chrome), sends them to [todoist](https://mikebian.co/todoist)\nwith a specified project and optionally a label, and outputs the list to the terminal (mostly for debugging). Only unique URLs are sent to Todoist, if you have a previous \"archive task\" with a URL archived it will not be archived again.\n\nThis utility has helped my mind and made it easy for me to find interesting things I've run into in the past. I've tied this into a 'first wake' [hyper focus](https://mikebian.co/hyper-focus) script to automatically run each morning when I first open my computer.\n\n## Installation\n\n```shell\npip install clean-workspace\n```\n\n- `TODOIST_API_KEY` has to exist in your shell environment for the tool to run.\n I recommend using [direnv](https://direnv.net/) to do this. Add your todoist token to `.envrc` and `direnv allow .`\n- Customize the url and domain blacklist\n\n## Usage\n\n```shell\nclean-workspace --help\nUsage: clean-workspace [OPTIONS]\n\nOptions:\n --blacklist-domains PATH\n --blacklist-urls PATH\n --tab-description TEXT Description for tab\n --todoist-label TEXT label in todoist for all created tasks [default:\n web-archive]\n --todoist-project TEXT project in todoist for all created tasks\n [default: Learning]\n --help Show this message and exit.\n```\n\n## Development\n\n```shell\npoetry install\npoetry run clean-workspace\n```\n\n### Regex Entries\n\nYou can use regex matches in both the url and domain blacklist files. For example, if you want to blacklist all Zoom domains, you can use the following:\n\n```shell\necho \"/.*zoom\\.us/\" >> ~/.config/clean-workspace/blacklist-domains.txt\n```\n\nA regex entry starts & ends with `/`, like `sed`.\n\n### Collecting Tab Description Via AppleScript\n\nHere's a quick script you can use to collect a description of what you were working on via applescript:\n\n```shell\ndialogResult=$(\nosascript <<EOT\nset dialogResult to display dialog \"What were you working on yesterday?\" buttons {\"OK\"} default button \"OK\" giving up after 300 default answer \"\"\nreturn text returned of dialogResult\nEOT\n)\n```\n\nHere's a [full example](https://github.com/iloveitaly/dotfiles/blob/648010ec9a9c8f1fb0aa70be138994689f3bbfb3/.config/focus/initial_wake.sh#L42-L53) of using this with [hyper-focus](https://www.raycast.com/iloveitaly/hyper-focus).\n\n## Debugging\n\nYou can use `ipython` to interactively play with the todoist API:\n\n```shell\nfrom clean_workspace import _todoist_api_key\napi = TodoistAPI(_todoist_api_key())\n```\n\n## Inspiration\n\n- <https://gist.github.com/aleks-mariusz/cc27b21f2c5b91fbd285>\n- <https://github.com/tominsam/shelf-python/blob/f357d9b147fa651034b71501edabf65f59d5befa/extractors/ComAppleSafari.py#L11>\n\n## TODO\n\n- [ ] Indicate in python config that this is macOS only in poetry config? I wonder if pyobjc does this in some way?\n- [ ] move blacklist files into example area of repo\n- [x] look at previous tasks and see if links are contained there before including them again\n- [ ] support google chrome canary\n- [ ] check to make sure regex gdrive urls work\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Collect all browser URLs, output to terminal, and archive to todoist. Useful for cleaning up your workspace at the end of the day, without loosing important urls.",
"version": "0.7.0",
"project_urls": {
"Homepage": "https://github.com/iloveitaly/clean-browser"
},
"split_keywords": [
"todoist",
" browser",
" productivity"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fe12d9b5494556d9ec8043c8049d5e15d9cbfe382555b7834df62106a9d6fc17",
"md5": "ca14530192507bb1a8a1cd7a2d23dcdc",
"sha256": "8a514ccc756968b72b46e4d1aa00f94ee43cb9f293bf00acb2b74a87db1620ab"
},
"downloads": -1,
"filename": "clean_workspace-0.7.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ca14530192507bb1a8a1cd7a2d23dcdc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 9913,
"upload_time": "2024-09-14T12:50:18",
"upload_time_iso_8601": "2024-09-14T12:50:18.025575Z",
"url": "https://files.pythonhosted.org/packages/fe/12/d9b5494556d9ec8043c8049d5e15d9cbfe382555b7834df62106a9d6fc17/clean_workspace-0.7.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "70ebefe8a3e2cb9d8f269d35af3508b76ecd8ff05b3e8739fe162cb1ab51345b",
"md5": "5771441c8313daa9877ea00005ff01a1",
"sha256": "2b81236a488b0e183ec66a90d73a8ae836372fb812a9c22d51bd79cee6d3351f"
},
"downloads": -1,
"filename": "clean_workspace-0.7.0.tar.gz",
"has_sig": false,
"md5_digest": "5771441c8313daa9877ea00005ff01a1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 8404,
"upload_time": "2024-09-14T12:50:18",
"upload_time_iso_8601": "2024-09-14T12:50:18.892827Z",
"url": "https://files.pythonhosted.org/packages/70/eb/efe8a3e2cb9d8f269d35af3508b76ecd8ff05b3e8739fe162cb1ab51345b/clean_workspace-0.7.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-14 12:50:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "iloveitaly",
"github_project": "clean-browser",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "clean-workspace"
}
JSON
