{"id":51327689,"url":"https://github.com/yemzikk/mac-terminal-screen-saver","last_synced_at":"2026-07-01T20:00:55.080Z","repository":{"id":368629462,"uuid":"1167260019","full_name":"yemzikk/mac-terminal-screen-saver","owner":"yemzikk","description":"A macOS screen saver that fills your screen with animated terminal windows running realistic fake commands — git logs, docker builds, kubernetes rollouts, npm installs, SQL queries, Rust cargo, AWS CLI, and more.","archived":false,"fork":false,"pushed_at":"2026-07-01T12:44:29.000Z","size":269,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-01T14:14:20.754Z","etag":null,"topics":["mac","macos","screensaver"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yemzikk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["yemzikk"],"buy_me_a_coffee":"yemzikk"}},"created_at":"2026-02-26T05:21:25.000Z","updated_at":"2026-07-01T12:44:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/yemzikk/mac-terminal-screen-saver","commit_stats":null,"previous_names":["yemzikk/mac-terminal-screen-saver"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/yemzikk/mac-terminal-screen-saver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yemzikk%2Fmac-terminal-screen-saver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yemzikk%2Fmac-terminal-screen-saver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yemzikk%2Fmac-terminal-screen-saver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yemzikk%2Fmac-terminal-screen-saver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yemzikk","download_url":"https://codeload.github.com/yemzikk/mac-terminal-screen-saver/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yemzikk%2Fmac-terminal-screen-saver/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35020872,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-01T02:00:05.325Z","response_time":130,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mac","macos","screensaver"],"created_at":"2026-07-01T20:00:49.683Z","updated_at":"2026-07-01T20:00:55.073Z","avatar_url":"https://github.com/yemzikk.png","language":"Swift","funding_links":["https://github.com/sponsors/yemzikk","https://buymeacoffee.com/yemzikk"],"categories":[],"sub_categories":[],"readme":"# Terminal Screen Saver\n\nA macOS screen saver that fills your screen with animated terminal windows running realistic fake commands — git logs, docker builds, kubernetes rollouts, npm installs, SQL queries, Rust cargo, AWS CLI, and more.\n\n🌐 **[Website \u0026 live demo →](https://yemzikk.github.io/mac-terminal-screen-saver/)** \u0026middot; ☕ **[Buy me a coffee](https://buymeacoffee.com/yemzikk)**\n\n## Features\n\n- **Multiple terminal windows** — 1–8 windows, arranged in automatic grid layouts\n- **Typewriter animation** — commands typed out character by character with natural timing variation\n- **Scrolling output** — command results appear line by line, then the window scrolls and repeats\n- **8 built-in themes** — Hack Green, Amber CRT, Classic White, Solarized Dark, Monokai, Dracula, Nord, Blue Pulse\n- **Per-window random themes** — each terminal can use a different theme\n- **Visual effects** — CRT scanlines, vignette glow, macOS-style traffic-light buttons, window shadows\n- **Live settings panel** — change everything from System Settings without editing any files\n\n## Command Categories\n\n| Category | Commands |\n|----------|----------|\n| Git | status, log, diff, stash |\n| Docker | ps, build, logs |\n| npm/Node | install, build, test |\n| Python/ML | pip install, training epochs |\n| Kubernetes | get pods/deployments, rollout status |\n| SSH | connect, systemctl status |\n| Rust/Cargo | build --release, test |\n| AWS CLI | s3 ls, cloudformation |\n| PostgreSQL | queries, EXPLAIN ANALYZE |\n| System | htop, df, uptime |\n| Network | ping, curl, netstat |\n| Files | ls, find, tar |\n| Processes | ps aux, lsof |\n\n## Requirements\n\n- macOS 12.0 (Monterey) or later\n- Xcode Command Line Tools (`xcode-select --install`)\n\n## Installation\n\n### Recommended: Build from Source\n\nLocally-built bundles aren't quarantined by Gatekeeper, so this is the smoothest install:\n\n```bash\ngit clone https://github.com/yemzikk/mac-terminal-screen-saver.git\ncd mac-terminal-screen-saver\nmake install\n```\n\nThis compiles a universal (Apple Silicon + Intel) binary and copies `TerminalScreenSaver.saver`\nto `~/Library/Screen Savers/`.\n\nOther build targets:\n\n```bash\nmake              # build .saver bundle only (no install)\nmake install      # build + install (current user)\nmake install-system   # build + install system-wide (sudo)\nmake clean        # remove build/ directory\nmake uninstall    # remove from ~/Library/Screen Savers\n```\n\n### Download a Pre-built Release\n\n1. Go to [Releases](https://github.com/yemzikk/mac-terminal-screen-saver/releases)\n2. Download either:\n   - **TerminalScreenSaver.dmg** — macOS disk image\n   - **TerminalScreenSaver.saver.zip** — compressed bundle\n3. Unzip / open the DMG and double-click `TerminalScreenSaver.saver`, then click **Install**\n\nThe screensaver installs to `~/Library/Screen Savers/`.\n\n\u003e **Gatekeeper note:** Released bundles are **ad-hoc signed but not notarized** (no paid Apple\n\u003e Developer account). Because they're downloaded from the internet, macOS quarantines them and may\n\u003e refuse to load the saver or warn about an \"unidentified developer.\" To clear the quarantine flag:\n\u003e\n\u003e ```bash\n\u003e xattr -dr com.apple.quarantine ~/Downloads/TerminalScreenSaver.saver\n\u003e ```\n\u003e\n\u003e (adjust the path to wherever the `.saver` ended up), then double-click it again.\n\u003e Building from source avoids this entirely.\n\n### Homebrew (tap)\n\nIf a tap is published, you can install via:\n\n```bash\nbrew tap yemzikk/tap\nbrew install --cask --no-quarantine terminal-screensaver\n```\n\n`--no-quarantine` is needed because the bundle is ad-hoc signed but not notarized.\nSetup instructions for publishing the tap live in\n[packaging/homebrew/README.md](packaging/homebrew/README.md).\n\n\u003e Not available in the main `homebrew/cask` repo, which requires notarized bundles.\n\n## Activate\n\n1. Open **System Settings → Screen Saver**\n2. Scroll down and select **Terminal Screen Saver**\n3. Click **Options…** or the gear icon to open the settings panel\n\n## Settings Panel\n\n| Setting | Description |\n|---------|-------------|\n| **Terminals** | Number of terminal windows (1–8) |\n| **Color Theme** | Choose from 8 built-in themes |\n| **Random Theme Per Window** | Each terminal gets a different theme |\n| **Font Size** | Terminal font size (8–18 pt) |\n| **Typing Speed** | Characters per second (5–120) |\n| **Corner Radius** | Window corner rounding |\n| **Terminal Opacity** | Window background transparency |\n| **Show Title Bar** | macOS-style title bar with traffic lights |\n| **Scanlines** | CRT scanline overlay |\n| **Vignette Glow** | Radial dark vignette around edges |\n| **Blinking Cursor** | Block cursor blinking |\n| **Window Shadow** | Outer glow shadow |\n\n## Releasing (maintainers)\n\nOne-click: **Actions → Bump \u0026 Release → Run workflow**. Pick a bump level\n(patch/minor/major) or type an explicit version. It bumps `Info.plist` and the\nHomebrew cask, commits, tags `vX.Y.Z`, then builds, publishes the GitHub Release\n(`.dmg` + `.zip`), and updates the Homebrew tap.\n\nFrom the CLI: `gh workflow run \"Bump \u0026 Release\" -f level=patch`\n(or `-f version=1.2.0`).\n\nPrefer to tag by hand? Pushing any `v*` tag also triggers the release build:\n\n```bash\ngit tag -a v1.2.0 -m \"Release v1.2.0\" \u0026\u0026 git push origin v1.2.0\n```\n\n## Project Structure\n\n```\nmac-terminal-screen-saver/\n├── Sources/TerminalScreenSaver/\n│   ├── Settings.swift              # Settings model + 8 built-in themes\n│   ├── CommandDatabase.swift       # 14 command categories with realistic output\n│   ├── TerminalWindowView.swift    # Terminal window rendering + typewriter animation\n│   ├── TerminalScreenSaverView.swift  # Main ScreenSaverView, layout engine\n│   └── ConfigSheetController.swift # Settings panel (fully programmatic NSPanel)\n├── Resources/\n│   └── Info.plist                  # Bundle metadata\n├── Makefile                        # Build + install rules\n└── README.md\n```\n\n## Themes Preview\n\n| Theme | Background | Text |\n|-------|-----------|------|\n| Hack Green | Near-black | Bright green |\n| Amber CRT | Dark amber | Warm amber/gold |\n| Classic White | Dark navy | Light grey/white |\n| Solarized Dark | Solarized base03 | Base0 |\n| Monokai | #282828 | Off-white |\n| Dracula | Purple-dark | Soft white |\n| Nord | Arctic dark | Arctic light |\n| Blue Pulse | Deep navy | Electric blue |\n\n## License\n\nMIT — do whatever you want with it.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyemzikk%2Fmac-terminal-screen-saver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyemzikk%2Fmac-terminal-screen-saver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyemzikk%2Fmac-terminal-screen-saver/lists"}