{"id":19898275,"url":"https://github.com/UnkwUsr/ticktask","last_synced_at":"2025-05-02T21:30:37.528Z","repository":{"id":128757907,"uuid":"423979608","full_name":"UnkwUsr/ticktask","owner":"UnkwUsr","description":"Simple cli for creating tasks on ticktick.com","archived":false,"fork":false,"pushed_at":"2025-02-07T20:03:13.000Z","size":20,"stargazers_count":43,"open_issues_count":0,"forks_count":6,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-11T22:38:08.543Z","etag":null,"topics":["api","cli","console","open-api","terminal","ticktick"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/UnkwUsr.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-11-02T19:51:35.000Z","updated_at":"2025-04-06T08:28:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"9de69c27-9a16-4e74-8618-ee2900054480","html_url":"https://github.com/UnkwUsr/ticktask","commit_stats":{"total_commits":19,"total_committers":1,"mean_commits":19.0,"dds":0.0,"last_synced_commit":"f48aef625d0f48b67aaadb1f0a78365a75e9113f"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UnkwUsr%2Fticktask","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UnkwUsr%2Fticktask/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UnkwUsr%2Fticktask/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UnkwUsr%2Fticktask/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UnkwUsr","download_url":"https://codeload.github.com/UnkwUsr/ticktask/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252108575,"owners_count":21696098,"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":["api","cli","console","open-api","terminal","ticktick"],"created_at":"2024-11-12T19:01:27.126Z","updated_at":"2025-05-02T21:30:37.523Z","avatar_url":"https://github.com/UnkwUsr.png","language":"Shell","readme":"# Ticktask\n\nTicktask is a simple cli for [ticktick](https://ticktick.com) to create tasks.\n\n## Features\n\n* Uses [official](https://developer.ticktick.com/docs#/openapi) open api (which\n  is still under development, but creating tasks is already work)\n* Support date (\\*today and \\*tomorrow)\n* Support tags (starts with #)\n* Support task body (see [config](#Config) section)\n\n## Installation\n\n### Manual\n\nJust save the\n[./ticktask](https://raw.githubusercontent.com/UnkwUsr/ticktask/master/ticktask)\nfile somewhere on your computer (for example, in `/usr/local/bin/`). Don't\nforget to set execute permission on file: `chmod +x /path/to/ticktask`\n\n## Setup\n\nYou need to obtain api key for ticktick, so go to\n[https://developer.ticktick.com/manage](https://developer.ticktick.com/manage)\nand create your \"app\". P.S. you will be asked for *ridirect_url* setting. Set\nit to anything you want, for example `http://127.0.0.1`.\n\nNext, you need to write your `cliend_id` and `client_secret` in config. Create\n`~/.config/ticktask/config.sh` file with the following content:\n\n```sh\nCLIENT_ID=\"your_client_id\"\nCLIENT_SECRET=\"your_client_secret\"\n```\n\nThen run `ticktask` and follow its instructions.\n\nCongratulations! Your token saved in `~/.local/share/ticktask/token`. Now you\ncan jump to usage section.\n\n## Usage\n\nJust run `ticktask` with your task title as argument. Example:\n\n```sh\nticktask my new task created with ticktask\n```\n\nYou can use date rules `*today` and `*tomorrow` which will be applied to task\nand removed from title text. The same for tags which starts with `#`.\n\nNote: if for some reasons ticktask can't send request to ticktick, your task\ntext will be saved in `~/.local/share/ticktask/error_tasks/` folder, so you\nwill never lose anything. P.S. in such situation ticktask exit with code 2, so\nyou can use it in your scripts (for example send notify with `notify-send`)\n\n### Use with hotkey\n\n[Personally](https://github.com/UnkwUsr/dotfiles/blob/d296e8629f9945efe67e699c0475d3202c53a8d5/config/i3/config#L241-L243),\nI use ticktask with [dmenu](https://tools.suckless.org/dmenu/). Command I use\nin hotkey:\n\n```bash\necho -n | dmenu -p \"ticktask:\" | xargs -0 ticktask \\\n       \u0026\u0026 notify-send ticktask -t 1000 sent \\\n       || notify-send ticktask -u critical -t 2000 \"not sent\"\n```\n\nIt opens dmenu prompt, then forwards result to tictask, and then sends notify\nwith status \"sent\" or \"not sent\".\n\n## Config\n\nConfig file located at `~/.config/ticktask/config.sh`. This is simply bash\nscript, so it's very hackable and extensible.\n\nFor examples see [./config.example.sh](./config.example.sh)\n\n### Task body (not necessary)\n\nTo be able to enter a task description, you can define function\n`cmd_get_description()` which should output the description as a result. For\nexample, you can run any gui program with prompt, which will then print it to\nstdout.\n\n## Related projects\n\n* [ticked](https://github.com/UnkwUsr/ticked) - allows you to edit your\n  [ticktick.com](https://ticktick.com) tasks in your favorite editor (like\n  vim/neovim).\n","funding_links":[],"categories":["Shell"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FUnkwUsr%2Fticktask","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FUnkwUsr%2Fticktask","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FUnkwUsr%2Fticktask/lists"}