# Install timedog with Homebrew

Lists files that were saved by a backup of the macOS Time Machine. Version 1.4 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:timedog
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install timedog
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:timedog
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/timedog>
- **Version:** 1.4
- **Source summary:** Lists files that were saved by a backup of the macOS Time Machine
- **Homepage:** <https://github.com/nlfiedler/timedog>
- **Repository:** <https://github.com/nlfiedler/timedog>
- **Upstream docs:** <https://github.com/nlfiedler/timedog#readme>
- **License:** GPL-2.0-or-later
- **Source archive:** <https://github.com/nlfiedler/timedog/archive/refs/tags/v1.4.tar.gz>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- timedog (cli)
- timedog (alias)

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.4
- Local data: ok
- Upstream repository: https://github.com/nlfiedler/timedog
- Upstream latest detected: v1.4 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

timedog is a small macOS-focused command-line utility for inspecting what files were saved by an Apple Time Machine backup.

### Project history

The official repository describes timedog as a Perl script that displays the files saved for a given Mac OS X Time Machine backup. By default, it reports the most recent backup and includes before-and-after sizes plus total counts and sizes.

The GitHub releases API for the official repository lists v1.4 in 2017, and the Homebrew metadata in the input shows that same stable version packaged for macOS users.

### Adoption history

timedog's adoption appears narrow and macOS-specific. The input package-manager data lists Homebrew only, which is consistent with a utility aimed at Time Machine backup inspection rather than general Unix backup workflows.

### How it is used

The tool is used after Time Machine has made a backup, when a user wants to see which files changed and how much space the backup consumed.

Its niche is diagnostic: it helps explain unexpectedly large Time Machine backups without opening a graphical backup browser.

### Why package nerds care

For package nerds, timedog is notable as a single-purpose script that fills a gap in macOS's built-in backup UI. Its Homebrew formula makes that old-school admin utility installable with one command.

### Timeline

- 2017: The official GitHub repository published v1.4.
- 2026: Input metadata lists timedog as a Homebrew package with executable `timedog`.

### Related projects

- timedog is tied to Apple's Time Machine backup system rather than to a family of timedog-specific companion tools.

### Sources

- <https://api.github.com/repos/nlfiedler/timedog/releases/latest - official GitHub API identifies v1.4 as the latest release.>
- <https://github.com/nlfiedler/timedog - official README describes the Perl script and its Time Machine backup-reporting behavior.>
- input.source_facts.package-manager - package-manager availability lists Homebrew only.


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** timedog
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Requirements:** macos
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Archive and compression packages](https://www.automicvault.com/pkg/archive-compression-tools/) - Matched archive or compression metadata.
- [dar](https://www.automicvault.com/pkg/brew/dar/) - Shares av.db curated category or tags: backup, cli, filesystem, system.
- [httm](https://www.automicvault.com/pkg/brew/httm/) - Shares av.db curated category or tags: backup, cli, filesystem, system.
- [rsnapshot](https://www.automicvault.com/pkg/brew/rsnapshot/) - Shares av.db curated category or tags: backup, cli, filesystem, system.
- [shallow-backup](https://www.automicvault.com/pkg/brew/shallow-backup/) - Shares av.db curated category or tags: backup, cli, macos, system.
- [afio](https://www.automicvault.com/pkg/brew/afio/) - Shares av.db curated category or tags: backup, cli, system.
- [bacula-fd](https://www.automicvault.com/pkg/brew/bacula-fd/) - Shares av.db curated category or tags: backup, cli, system.
- [borgbackup](https://www.automicvault.com/pkg/brew/borgbackup/) - Shares av.db curated category or tags: backup, cli, system.
- [borgmatic](https://www.automicvault.com/pkg/brew/borgmatic/) - Shares av.db curated category or tags: backup, cli, system.
- [rsync-time-backup](https://www.automicvault.com/pkg/brew/rsync-time-backup/) - Local package facts share a topical domain. Shared terms: backup, cli, machine, system, time.

## Combined YAML source

View the package source record on GitHub. [combined/timedog.yml](https://github.com/automic-vault/db/blob/main/combined/timedog.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
