{"id":20522447,"url":"https://github.com/fiskeben/speck","last_synced_at":"2025-04-14T03:01:43.277Z","repository":{"id":139138749,"uuid":"117376400","full_name":"fiskeben/speck","owner":"fiskeben","description":"micro.blog for the command line.","archived":false,"fork":false,"pushed_at":"2019-12-18T19:14:46.000Z","size":35,"stargazers_count":19,"open_issues_count":3,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-27T16:56:11.646Z","etag":null,"topics":["blogging","cli","go","golang"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fiskeben.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2018-01-13T20:37:16.000Z","updated_at":"2020-09-04T03:31:37.000Z","dependencies_parsed_at":"2024-06-20T04:18:51.487Z","dependency_job_id":"efb93733-1f1a-4583-8279-c286e71bda3a","html_url":"https://github.com/fiskeben/speck","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiskeben%2Fspeck","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiskeben%2Fspeck/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiskeben%2Fspeck/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiskeben%2Fspeck/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fiskeben","download_url":"https://codeload.github.com/fiskeben/speck/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248813789,"owners_count":21165633,"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":["blogging","cli","go","golang"],"created_at":"2024-11-15T22:35:29.577Z","updated_at":"2025-04-14T03:01:43.236Z","avatar_url":"https://github.com/fiskeben.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# speck - a micro.blog CLI\n\n`speck` is a command line tool for managing a micro.blog account.\n\n## Getting started\n\n### Install with `homebrew`\n\nYou can install `speck` with\n[Homebrew](https://brew.sh)\nin two easy steps\n(given that you have Homebrew installed):\n\n1. Add my tap: `brew tap fiskeben/homebrew-tap`\n1. Install `speck`: `brew install speck`\n\nDon't forget to read the paragraph about configuration below.\n\n### Building and installing manually\n\nThe tool is written in Go and currently requires you to have Go installed\nin order to build the binary.\n\n`make build` will build the binary and put it in this folder.\n\nUse `make install` to install `speck`. This will create an executable\ncalled `speck` and add it to your Go bin folder.\nAdd the folder to your `$PATH` if you want.\n\n### Configuring `speck`\n\nYou need a token from micro.blog to use the tool.\n[Create a new token here](https://micro.blog/account/apps)\nand put it in a file called `.speck.yml`,\nalong with your username, like this:\n\n```yaml\n---\nusername: your-micro-blog-username\ntoken: your-token\n```\n\nSave the file to either your home directory or current working directory.\n\n## Usage and features\n\nCurrently `speck` is very limited.\nIt can retrieve your timeline and create new posts.\n\n### Timeline\n\nRun `speck` without any parameters to get your timeline.\nPipe the output to `less` to better read it.\n\n### Posting\n\nRun `speck post` to create a new post.\nThis will open your `$EDITOR` (or `vi` if it's not set)\nand you can write your post there. When you save and exit the editor\nthe post will be created on your micro blog.\n\nIf what you wrote is longer than 280 characters,\nyour editor will repoen and you need to make it shorter.\n\nIt's also possible to post something you already have on file,\nlike so: `speck post \u003cpath/to/file\u003e`\n\n## TODO and upcoming features\n\nThese are some of the features I want to add soon:\n\n* [x] Pass a file to `speck post` so that you can write posts independently from posting.\n* [x] A `--dry-run` flag.\n* [ ] Post display:\n  * [ ] Parsing/stripping HTML\n  * [ ] Limiting output width to avoid super long lines of text\n  * [ ] URL to photos.\n* [x] Adding help text to the editor (like `git commit`)\n* [x] Save the post locally as well as posting it to micro.blog.\n* [ ] Multiple accounts.\n* [ ] Setup command that writes the `.speck.yml` config.\n* [ ] Implement more of the features from the API such as ~(un)following~, reading users' timelines etc.\n* [ ] Open user's micro.blog profile/timeline in a browser.\n* [ ] Don't be an \"app\" with lots of friendly, formatted output. Output should be possible to pipe to another program.\n* [ ] Use `stdin` as source for post text.\n* [ ] Some sort of CI/CD and ~Homebrew cask for easy installation~.\n\nIf you have any requests for new features or just want to give some feedback\ncreate an issue or reach out at [hi@ricco.me](mailto:hi@ricco.me).\nYou can also [follow me on micro.blog](https://micro.blog/ricco).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiskeben%2Fspeck","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffiskeben%2Fspeck","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiskeben%2Fspeck/lists"}