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 里写作'Darker than dark'):一位契约者不断使用能力却从不支付代价,最终会失去控制,变成没有感情的 Doll(人偶)。过度透支'专注力'而不付出代价——比如及时回复队友——同样引出一个问题:我们最终会变成什么?
Size
3 MB
Stars
1.2K
Age
4y
Commits · 90 Days