KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #ai #dsh-plugin #ai-agent #mcp #deepseek-harness #windows

textbar-timemachine

★ 32 Open GitHub ↗

A TextBar script to monitor the status of your Time Machine / Time Capsule backups

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# textbar-timemachine

A [TextBar](http://richsomerfield.com/apps/textbar/) script to monitor the status of your Time Machine / Time Capsule backups.

-----

Here is what it looks like when a Time Machine backup is active:

![textbar-timemachine screenshot](https://raw.githubusercontent.com/tjluoma/textbar-timemachine/master/textbar-timemachine-screenshot.png)

Note the ‘47%’ in the menu bar. That’s the only part which is visible until I click on it.

The ‘47%’ represents how much of the backup is done.

When Time Machine is not backing up, there’s nothing shown there.

If there is another part of the Time Machine process happening, it will be shown there in a CamelCasedWord, such as:

* Copying
* DeletingOldBackups
* Finishing
* HealthCheckCopyHFSMeta
* HealthCheckFsck
* MountingBackupVol
* MountingBackupVolForHealthCheck
* Starting
* ThinningPostBackup
* ThinningPreBackup

(There may be others. Those are the only ones that I’ve noticed.)

Everything from the line ‘Backup session status’ down to ‘Updated’ is the output of the command `tmutil status` which gives you a lot of detail about what’s going on with your Time Machine backup, but it’s not in the most user-friendly or readable format.

The purpose of the script `textbar-timemachine.sh` is to parse `tmutil status` into the friendlier format shown at the top.

The files `bytes2readable.sh`, `commaformat.sh`, and `seconds2readable.sh` are all files that are used by `textbar-timemachine.sh`

## Some things to note:

- When the progress meter gets to about 90% it will stop, sometimes for a long time. Then it will say that it is finished. I’ve never seen it actually show anything above 90% completed.

- The Time Remaining can sometimes be off by a large margin, so I wouldn’t rely on it. Use it as a guide. (The “ETA” is simply a calculation of the “Time Remaining” added to the current time, so if one is wrong, the other will be too.)

- I have often seen Time Machine claiming to backup far more data than I have on my drive, sometimes far more data than could fit on my drive if it was 100% full (even when it was mostly empty). Try not to worry about that. It’s normal.

## Potential Bugs

I have tested this script with _one_ local Time Machine drive (that is, a drive that I physically attach to my Mac) and one Time Capsule drive (a network location).

However, you could have multiple local drives, or multiple Time Capsule drives. If that happens, parts of this script might get confused, but the basic functionality of monitoring the process should still work fine.

## Installation

I recommend putting all four of the `.sh` files in `/usr/local/bin/`.

Make sure they are executable: `chmod a+rx /usr/local/bin/*.sh`

Once you have them installed, download and install [TextBar](http://richsomerfield.com/apps/textbar/).

Click the `+` button at the bottom left of the **TextBar - Preferences** window. Give it a name -- I recommend “Time Machine” but you go with whatever feels right.

In the “Script” field, select `/usr/local/bin/textbar-timemachine.sh`

In the “Refresh” field, select how often (in seconds) it should update.

Turn “Notifications” _off_ unless you want a notification every time it changes (which might be interesting in the beginning but will get old quickly).

It should look something like this:

![TextBar Screenshot](https://raw.githubusercontent.com/tjluoma/textbar-timemachine/master/TextBar-Preferences-TimeMachine.png)

Voilà! Now you’re up and running.

## Questions?

If you have questions, [create a new issue](https://github.com/tjluoma/textbar-timemachine/issues/new) here and I will do my best to answer it.

(It's best to ask questions here vs email or on other forums, so that others who find it can see the Q&A.)

textbar-timemachine

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README