{"id":13496708,"url":"https://github.com/kattouf/ProgressLine","last_synced_at":"2025-03-28T19:30:53.291Z","repository":{"id":247016241,"uuid":"823081795","full_name":"kattouf/ProgressLine","owner":"kattouf","description":"⏳Track commands progress in a compact one-line format","archived":false,"fork":false,"pushed_at":"2025-01-09T12:31:40.000Z","size":2384,"stargazers_count":188,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-28T12:02:10.464Z","etag":null,"topics":["activity","activity-indicator","bash","cli","command-line","command-line-tool","developer-tools","linux","macos","progress","progress-bar","progress-tracker","progressbar","script","spinner","swift","swift-cli","terminal","utilities","zsh"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kattouf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-07-02T11:43:36.000Z","updated_at":"2025-03-23T23:12:38.000Z","dependencies_parsed_at":"2024-11-16T22:02:12.251Z","dependency_job_id":"8219a511-1e96-4062-a401-b3f305d98d2c","html_url":"https://github.com/kattouf/ProgressLine","commit_stats":{"total_commits":37,"total_committers":2,"mean_commits":18.5,"dds":"0.027027027027026973","last_synced_commit":"120aec3981d51d3216c6a3941610f15c0dd19b3c"},"previous_names":["kattouf/progressline"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kattouf%2FProgressLine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kattouf%2FProgressLine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kattouf%2FProgressLine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kattouf%2FProgressLine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kattouf","download_url":"https://codeload.github.com/kattouf/ProgressLine/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246088392,"owners_count":20721678,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["activity","activity-indicator","bash","cli","command-line","command-line-tool","developer-tools","linux","macos","progress","progress-bar","progress-tracker","progressbar","script","spinner","swift","swift-cli","terminal","utilities","zsh"],"created_at":"2024-07-31T19:01:57.557Z","updated_at":"2025-03-28T19:30:53.285Z","avatar_url":"https://github.com/kattouf.png","language":"Swift","readme":"## ProgressLine\n\n![](https://img.shields.io/badge/Platform-macOS-6464aa)\n![](https://img.shields.io/badge/Platform-Linux-6464aa)\n[![Latest Release](https://img.shields.io/github/release/kattouf/ProgressLine.svg)](https://github.com/kattouf/ProgressLine/releases/latest)\n![](https://github.com/kattouf/ProgressLine/actions/workflows/checks.yml/badge.svg?branch=main)\n\nTrack commands progress in a compact one-line format.\n\n| ⏳ `progressline` output |\n|:--:|\n| ![](./.github/progressline_output.gif) |\n\n| 📝 standard output |\n|:--:|\n| ![](./.github/standard_output.gif) |\n\n[Usage](#usage) • [Features](#features) • [Installation](#installation)\n\n## Usage\n\nSimply pipe your command output into `progressline` to start tracking:\n\n```sh\nlong-running-command | progressline\n```\n\nIf the command you are executing also writes data to `stderr`, then you should probably use [\"redirection\"](https://www.gnu.org/software/bash/manual/html_node/Redirections.html) and send `stderr` messages to `stdout` so that they also go through the `progressline`:\n\n``` sh\nlong-running-command 2\u003e\u00261 | progressline\n```\n\n## Features\n\n### Change activity indicator styles\n\nProgressLine offers different styles to represent activity, they can be changed using `-s, --activity-style` option:\n\n``` sh\nlong-running-command | progressline --activity-style snake\n```\n\nAvailable styles:\n\n| dots (Default) | snake | [kitt](https://en.wikipedia.org/wiki/KITT) | spinner |\n|:--:|:--:|:--:|:--:|\n| ![](./.github/activity_style_dots.gif) | ![](./.github/activity_style_snake.gif) | ![](./.github/activity_style_kitt.gif) | ![](./.github/activity_style_spinner.gif) |\n\n### Replace log output with custom text\n\nIf you don't need to see the log output during execution, even in a single line, you can replace it with your own text using the `-t, --static-text` option.\n\n``` sh\nlong-running-command | progressline --static-text \"Updating sources...\"\n```\n\n### Highlight important lines\n\nLog specific stdin lines above the progress line using the `-m, --log-matches` option:\n\n``` sh\nlong-running-command | progressline --log-matches \"regex-1\" --log-matches \"regex-2\"\n```\n\n### Use progress line as an addition to standard output\n\nLog all stdin data above the progress line using the `-a, --log-all` option:\n\n```sh\nlong-running-command | progressline --log-all\n```\n\n### Save original log\n\nYou have two options for saving the full original log:\n\n1. Using [tee](https://en.wikipedia.org/wiki/Tee_(command))\n\n``` sh\nlong-running-command | tee original-log.txt | progressline\n```\n\n2. Using `-l, --original-log-path` option:\n\n``` sh\nlong-running-command | progressline --original-log-path original-log.txt\n```\n\n## Installation\n\n### [Homebrew](https://brew.sh) (macOS / Linux)\n\n``` sh\nbrew install progressline\n```\n\n\u003c/details\u003e\n\n### [Mint](https://github.com/yonaskolb/Mint) (macOS)\n\n``` sh\nmint install kattouf/ProgressLine\n```\n\n### [Mise](https://mise.jdx.dev) (macOS)\n\n``` sh\nmise use -g spm:kattouf/ProgressLine\n```\n\n### Manual Installation (macOS / Linux)\n\nDownload the binary for your platform from the [releases page](https://github.com/kattouf/ProgressLine/releases), and place it in your executable path.\n\n## Contributing\n\nFeel free to open a pull request or a discussion.\n","funding_links":[],"categories":["Swift","\u003ca name=\"utility\"\u003e\u003c/a\u003eUtilities"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkattouf%2FProgressLine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkattouf%2FProgressLine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkattouf%2FProgressLine/lists"}