listOK is a Telegram bot for keeping track of shopping lists and context-dependent tasks. Try it out in Telegram . I describe the rationale and some technical details in a series of posts.

Please feel free to leave any questions, bug reports, requests or suggestions in the comments below or contact me via email stan@shallowdepth.online .

Features

📝 Basics

The bot can keep track of any number of lists (you create lists yourselves, it is just an example):

User’s list

Lists contain items which can be either active or done:

List contents and items

Adding items is smart: if listOK finds that there are similar items in the list it will suggest to use one of them or create a new one. It also doubles as search.

Create items and search in a smart way

If the list already contains an identical item (case-insensitive), the bot will will just mark it as active, if was done.

listOK item deduplication

🔁 Recurring items

To make an item recurring add to its end *1d (with at least one space after the item’s text), where 1 is the number of days since the item has been marked done after which it will again become active.

For example, if you buy bread on average every three days, the item text may look like Bread *3d. It will automatically become active once every three days – you just need to interact with the bot in any way.

🌐 Languages

English and Russian. Other localizations are possible if needed, will require assistance from speakers.

Choose language menu

📱 Create a shortcut for the bot

You can create a shortcut to access the bot in one click from anywhere: your phone, computer, etc. Follow this how to and use the link https://telegram.me/list_ok_bot or tg://resolve?domain=list_ok_bot.

Example of the shortcut on iPhone (third icon):

Shortcut for the telegram bot

🆕 Changelog

2022-02-19 – 0.6.2:

  • More detailed response to unsupported message types: audio, video, images, etc.

  • Minor improvements and bugfixes.

2022-02-14 – 0.6.1: Add option to copy in one click current name of a list or item during editing and deleting. Helps to avoid retyping it again.

2022-02-13 – 0.6.0: Add recurring items.

2022-02-06 – 0.5.0:

  • Added option to delete lists. Important: it also deletes items in the lists. It is irreversible.

  • Actions to edit and delete lists is now accessible in the “edit mode”, the same as with items in lists.

  • Minor improvements and bugfixes.

2022-02-02 – 0.4.0:

  • Now you can search/add items without opening a list: if you have one list, it would work the same as if you opened the list. If you have several lists, the bot will ask which list to work with.

  • Improved work of smart item creation/search: if you type exact match for an existing item, but there are other similar items, the bot will offer to choose among them. For example, if you have items oil, olive oil, and sesame oil, in response to oil the bot will offer all three options, instead of just making oil active.

2022-01-13 – 0.3.2:

  • case-insensitive sorting of lists and items
  • more detailed message on unknown input
  • minor improvements and bugfixes

2022-01-06 – 0.3.1: Minor improvements and bugfixes

2022-01-05 – 0.3.0: Add smart item creation/search in lists

2022-01-04 – 0.2.3: Add pagination for done items: now they are split into pages of maximum 10 items

2022-01-02 – 0.2.2: Add popup notification when changing status of an item to make the result of the action more obvious

2021-12-02 – 0.2.1: Minor bugfix and improvements

2021-11-22 – 0.2.0: Add multi-language support and Russian translation

2021-11-01 – 0.1.0: First public release, basic functionality

Credits

The icon in the logo: The Noun Project .