Doll README

The project's README from github.com/xiaogdgenuine/Doll. As one markdown file: README.md.

Doll is a Mac app that help you catch up important messages!

In macOS, It feels really great when you hide the Dock, open a full screen window and focus on your task.

But we are not living in an ideal world, your teammates may need your help anytime, and when you are in focus mode, occasionally you just forgot to respond!

Message apps like Mail, Slack and Microsoft Teams don't even offer a menu bar icon at all, so if you're working in a full screen window, or looking at another extra Monitor screen which can't show the Dock, there is no way you will notice the unread messages!

Basic usage

(Sorry the notification center did notice you, but they will soon dismiss after a short period, if you miss that, you miss the message)

Notification center

It would be great if we could put the icon and badge of these apps into the Menu bar, that way we can always easily notice new messages across screens, just like this:

Show case

Doll?

In my favor animation 《Darker than dark》, if a Contractor use his power and never willing to pay the cost, eventually he will lose control of his power, become an emotionless Doll.

If we use too much focus power without paying the cost, what will we become >>__<<.

Install

You can download the latest dmg file from here Minimum system requirement: macOS 11.0 (Big Sur)

How to use?

It's simple, click on "+" button at the left bottom corner, search and select the app you want to monitor:

Add monitor

Search and select

Then Doll will ask for your permission to use the Accessibility API:

ask-for-permission.png

Please make sure you grant that permission to Doll.app otherwise nothing will be monitored!

grant-permission.png

Done, you are all setup! Doll now will monitor all the badge update in the Dock, and sync the numbers into the menu bar!

running.png

Doll also can show new notification as red badge, just like in dock!

show as badge

I want to change the Monitor apps

If the monitored app is running, click on the menu bar icon will simply open that app.

But if you want to change stuffs, use right click, or left click while holding the "Option key(⌥)".

config.png

Security concern about the permission?

Never! Ever! Trust! Anybody! in Internet!

Doll is open source, you are free to download, review, modify and compile your own version of the app, go ahead and happy coding~

How the app works?

Doll utils the macOS Accessibility API, it will sync the latest badge text to menu bar from every Monitored app in the Dock element.

Due to the limitation of Accessibility API(Can't watch for element's attribute value change), Doll has to sync badges by every second(Yep, the infamy Polling style).

But don't worry about the performance, after all the synchronization happens only 86400 times per day, and all it does is just read and set few element's text, that's an operation executed less than 1ms!

If you found any potential Bug or Performance issue, feel free to submit a PR!

Love this app?

Buy Me A Coffee

Doll (xiaogdgenuine/Doll)

Searching Database…

1.2K ·GitHub
Что это такое?Doll — это приложение для Mac, которое держит бейджи непрочитанных сообщений почтовых и мессенджеров вроде Mail, Slack и Teams видимыми в строке меню macOS, чтобы новые сообщения бросались в глаза на любом экране.
Я увижу сами сообщения в строке меню?Нет — Doll показывает иконку каждого отслеживаемого приложения и его бейдж (количество непрочитанных), визуальное напоминание о том, что вас кто-то ждёт. Читать сообщения вы всё равно будете в самом приложении.
За какими приложениями оно следит?В README упоминаются Mail, Slack и Microsoft Teams — мессенджеры, у которых нет собственной иконки в строке меню.
Разве нельзя просто посмотреть на бейджи непрочитанных в Dock?Не тогда, когда это важнее всего: если Dock скрыт, приложение развёрнуто на весь экран или ваше внимание на втором мониторе, где Dock не виден, бейджи в Dock просто не разглядеть.
Почему приложение называется Doll?По любимому аниме автора (в README оно названо «Темнее темного»): Контрактор, который использует свою силу и никогда не платит цену, в итоге теряет контроль и превращается в бездушную Doll — куклу. Злоупотребление «силой сосредоточенности» без уплаты цены — отвечая коллегам по команде — ставит тот же вопрос: кем мы станем?
Size
3 MB
Stars
1.2K
Age
4y
Commits · 90 Days