{"id":26202652,"url":"https://github.com/davep/braindrop","last_synced_at":"2025-04-09T22:11:37.087Z","repository":{"id":270466352,"uuid":"895471066","full_name":"davep/braindrop","owner":"davep","description":"A terminal-based client for raindrop.io","archived":false,"fork":false,"pushed_at":"2025-02-23T21:28:18.000Z","size":3414,"stargazers_count":43,"open_issues_count":6,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-02T00:37:11.521Z","etag":null,"topics":["bookmarking","bookmarking-app","bookmarks","bookmarks-manager","chui","python","python3","raindrop","raindrop-api","raindrop-io","terminal","terminal-based","textual","tui"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/braindrop/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/davep.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","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},"funding":{"ko_fi":"davepearson"}},"created_at":"2024-11-28T09:17:39.000Z","updated_at":"2025-03-31T04:46:21.000Z","dependencies_parsed_at":"2024-12-31T12:03:32.816Z","dependency_job_id":"a17f458a-c55f-46d7-ac57-49ab707f6bcb","html_url":"https://github.com/davep/braindrop","commit_stats":null,"previous_names":["davep/braindrop"],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davep%2Fbraindrop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davep%2Fbraindrop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davep%2Fbraindrop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davep%2Fbraindrop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davep","download_url":"https://codeload.github.com/davep/braindrop/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248119294,"owners_count":21050755,"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":["bookmarking","bookmarking-app","bookmarks","bookmarks-manager","chui","python","python3","raindrop","raindrop-api","raindrop-io","terminal","terminal-based","textual","tui"],"created_at":"2025-03-12T03:48:32.207Z","updated_at":"2025-04-09T22:11:37.057Z","avatar_url":"https://github.com/davep.png","language":"Python","funding_links":["https://ko-fi.com/davepearson"],"categories":["terminal"],"sub_categories":[],"readme":"# Braindrop\n\n![Braindrop](https://raw.githubusercontent.com/davep/braindrop/refs/heads/main/.images/braindrop-social-banner.png)\n\n## Introduction\n\nBraindrop is a terminal-based client application for the [raindrop.io\nbookmarking service](https://raindrop.io/). It provides the ability to\nmanage and search your bookmarks in the terminal.\n\nBraindrop is and generally always will be fairly opinionated about the\n\"best\" way to make use of Raindrop (AKA how I like to use it); but where\npossible I want to keep it quite general so it will be useful to anyone.\n\n\u003e [!NOTE]\n\u003e Braindrop isn't designed as a thin client for the Raindrop API; it isn't a\n\u003e terminal-based browser that does all the work on the server. It is\n\u003e designed to download your data if it looks like it's newer on the server,\n\u003e and then work locally, sending updates back to the server.\n\u003e\n\u003e If you have a *huge* Raindrop collection then this might not be the tool\n\u003e for you.\n\n## Installing\n\n### pipx\n\nThe package can be installed using [`pipx`](https://pypa.github.io/pipx/):\n\n```sh\n$ pipx install braindrop\n```\n\nOnce installed run the `braindrop` command.\n\n### Homebrew\n\nThe package is available via Homebrew. Use the following commands to install:\n\n```sh\n$ brew tap davep/homebrew\n$ brew install braindrop\n```\n\nOnce installed run the `braindrop` command.\n\n## Getting started\n\nBraindrop only works if you have a [raindrop.io](https://raindrop.io/)\naccount; there is a perfectly usable free tier. If you don't have an\naccount, go get one first.\n\nTo use Braindrop you will need an API access token. You can generate one in\nyour account settings, under `Integrations`. In `Integrations`:\n\n- Look for the `For Developers` section\n- Click on `Create new app`\n- Enter a name for the new app (call it `Braindrop` for example, so you know\n  what you're using it for).\n- Accept the API use terms and guidelines and press `Create`\n- Click on the freshly-created application in the list\n- Near the bottom of the dialog that appears, click on `Create test token`\n  and say `OK`.\n- Copy the test token to your clipboard (or don't worry if you misplace it,\n  you can always come back here to get it again).\n\nHaving done the above, when you run up Braindrop the first time it will ask\nfor this token:\n\n![Raindrop API token entry dialog](https://raw.githubusercontent.com/davep/braindrop/refs/heads/main/.images/raindrop-token-entry.png)\n\nPaste the token into the input field and select `Connect`. Braindrop will\nthen download your data and you will be good to go.\n\n*NOTE: if it's your preference, you can set the token in an environment\nvariable called `BRAINDROP_API_TOKEN`.*\n\n## Using Braindrop\n\nThe best way to get to know Braindrop is to read the help screen, once in the\nmain application you can see this by pressing \u003ckbd\u003eF1\u003c/kbd\u003e.\n\n![Braindrop help](https://raw.githubusercontent.com/davep/braindrop/refs/heads/main/.images/braindrop-help.png)\n\n## File locations\n\nBraindrop stores files in a `braindrop` directory within both\n[`$XDG_DATA_HOME` and\n`$XDG_CONFIG_HOME`](https://specifications.freedesktop.org/basedir-spec/latest/).\nIf you wish to fully remove anything to do with Braindrop you will need to\nremove those directories too.\n\nExpanding for the common locations, the files normally created are:\n\n- `~/.config/braindrop/configuration.json` -- The configuration file.\n- `~/.local/share/braindrop/.token` -- The file that hold your API token.\n- `~/.local/share/braindrop/raindrops.json` -- The locally-held Raindrop data.\n\n## Getting help\n\nIf you need help, or have any ideas, please feel free to [raise an\nissue](https://github.com/davep/braindrop/issues) or [start a\ndiscussion](https://github.com/davep/braindrop/discussions).\n\n## TODO\n\nSee [the TODO tag in\nissues](https://github.com/davep/braindrop/issues?q=is%3Aissue+is%3Aopen+label%3ATODO)\nto see what I'm planning.\n\n[//]: # (README.md ends here)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavep%2Fbraindrop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavep%2Fbraindrop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavep%2Fbraindrop/lists"}