{"id":15352173,"url":"https://github.com/turbaszek/gonotes","last_synced_at":"2025-08-23T23:11:31.595Z","repository":{"id":44736137,"uuid":"228228385","full_name":"turbaszek/gonotes","owner":"turbaszek","description":"Command line tool to  access your kindle clippings","archived":false,"fork":false,"pushed_at":"2022-03-20T18:55:02.000Z","size":698,"stargazers_count":23,"open_issues_count":2,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-14T06:47:56.503Z","etag":null,"topics":["cli","clippings","ebooks","go","golang","kindle","notes"],"latest_commit_sha":null,"homepage":"","language":"Go","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/turbaszek.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}},"created_at":"2019-12-15T18:06:14.000Z","updated_at":"2023-11-05T21:47:47.000Z","dependencies_parsed_at":"2022-09-07T03:21:34.715Z","dependency_job_id":null,"html_url":"https://github.com/turbaszek/gonotes","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turbaszek%2Fgonotes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turbaszek%2Fgonotes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turbaszek%2Fgonotes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turbaszek%2Fgonotes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/turbaszek","download_url":"https://codeload.github.com/turbaszek/gonotes/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248981257,"owners_count":21193143,"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":["cli","clippings","ebooks","go","golang","kindle","notes"],"created_at":"2024-10-01T12:08:55.861Z","updated_at":"2025-04-14T23:40:46.133Z","avatar_url":"https://github.com/turbaszek.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"![CI](https://github.com/turbaszek/gonotes/workflows/CI/badge.svg)\n[![Go Report Card](https://goreportcard.com/badge/github.com/turbaszek/gonotes)](https://goreportcard.com/report/github.com/turbaszek/gonotes)\n[![MIT license](https://img.shields.io/badge/license-MIT-brightgreen.svg)](https://opensource.org/licenses/MIT)\n\n# GoNotes\nCommand line tool to manage and search your Kindle clippings in an easy way!\n\n![book_list](docs/list.gif)\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n**Table of Contents**\n\n- [Usage](#usage)\n- [Help](#help)\n- [Autocomplete](#autocomplete)\n- [Installation](#installation)\n- [Development](#development)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\n## Usage\nParse your clippings files from Kindle:\n```\n➜ gonotes parse /path/to/your/clippings.txt\n```\n\nThen you can list notes from a book. Press tab use autocomplete\n(check how to [enable](#autocomplete) it):\n```\n➜ gonotes notes 8  # shows notes from book with ID 8\n```\n\nYou can display notes from single book and **search using grep**:\n```\n➜ gonotes notes 3 | grep tourism\ntourism is about helping people construct stories and collect memories.\n```\n\nRemember to use [cowsay](https://en.wikipedia.org/wiki/Cowsay) to share your\nfavourite quotes!\n```\n➜ gonotes n 12 | grep \"personal growth\" | cowsay\n ______________________________________\n/ Simply having enough money to spare  \\\n| converts the vicious cycle of stress |\n| and poor decision making into a      |\n\\ virtuous cycle of personal growth.   /\n --------------------------------------\n        \\   ^__^\n         \\  (oo)\\_______\n            (__)\\       )\\/\\\n                ||----w |\n                ||     ||\n```\n\nThere's also possibility to get a random quote that will be no longer\nthan specified number of words\n```\n➜ gonotes r -q -l 15 | cowsay -f bunny\n ________________________________________\n/ Hate is just as injurious to the hater \\\n| as it is to the hated. - The           |\n| Autobiography of Martin Luther King,   |\n\\ Jr. (Carson, Clayborne)                /\n ----------------------------------------\n  \\\n   \\   \\\n        \\ /\\\n        ( )\n      .( o ).\n```\n\n## Help\n\u003c!-- AUTO_STAR --\u003e\n```\n  NAME:\n     gonotes - manage your Kindle notes.\n\n     For more information check https://github.com/turbaszek/gonotes\n\n  USAGE:\n     gonotes [global options] command [command options] [arguments...]\n\n  VERSION:\n     v0.1\n\n  COMMANDS:\n     parse, p   Parses provided file and creates books and notes\n     book, b    Utilities to manage books\n     notes, n   List notes\n     random, r  Shows a random note\n     help, h    Shows a list of commands or help for one command\n\n  GLOBAL OPTIONS:\n     --help, -h     show help (default: false)\n     --version, -v  print the version (default: false)\n```\n\u003c!-- AUTO_END --\u003e\n\n## Autocomplete\nTo set up autocomplete including book hints run one of the following:\n```\n# bash\nsource \u003c(gonotes completion bash)\n\n# zsh\nsource \u003c(gonotes completion zsh)\n```\nTo persist the autocomplete behaviour add this selected option to\nyour `.bashrc` or `.zshrc`.\n\n## Installation\nCurrently, you can install GoNotes in two ways:\n- clone the repo and then `go install ./cmd/gonotes` - this will install actual master\n- download the binary:\n    ```\n    curl -L https://github.com/turbaszek/gonotes/releases/download/v0.1/gonotes -o /usr/local/bin/gonotes \u0026\u0026 chmod +x /usr/local/bin/gonotes\n    ```\n\n## Development\nFeel free to open issues and PRs. To build the project follow are usuall go steps. Consider using\n[pre-commits](https://pre-commit.com) for static checks and code formatting. On Mac this should do:\n```\nbrew install pre-commit\npre-commit install\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fturbaszek%2Fgonotes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fturbaszek%2Fgonotes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fturbaszek%2Fgonotes/lists"}