{"id":20197756,"url":"https://github.com/mohamedelashri/free-mac","last_synced_at":"2025-08-17T10:34:53.154Z","repository":{"id":224858790,"uuid":"764406339","full_name":"MohamedElashri/free-mac","owner":"MohamedElashri","description":"A free-like memory monitor tool for MacOS. ","archived":false,"fork":false,"pushed_at":"2025-03-29T16:36:47.000Z","size":56,"stargazers_count":5,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-29T17:29:48.131Z","etag":null,"topics":["cli","free","macos","memory-monitoring"],"latest_commit_sha":null,"homepage":"","language":"C","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/MohamedElashri.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-02-28T02:32:58.000Z","updated_at":"2025-03-29T16:34:33.000Z","dependencies_parsed_at":"2024-11-14T07:16:05.069Z","dependency_job_id":null,"html_url":"https://github.com/MohamedElashri/free-mac","commit_stats":null,"previous_names":["mohamedelashri/free-mac"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/MohamedElashri/free-mac","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohamedElashri%2Ffree-mac","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohamedElashri%2Ffree-mac/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohamedElashri%2Ffree-mac/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohamedElashri%2Ffree-mac/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MohamedElashri","download_url":"https://codeload.github.com/MohamedElashri/free-mac/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohamedElashri%2Ffree-mac/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270837400,"owners_count":24654374,"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","status":"online","status_checked_at":"2025-08-17T02:00:09.016Z","response_time":129,"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":["cli","free","macos","memory-monitoring"],"created_at":"2024-11-14T04:28:06.990Z","updated_at":"2025-08-17T10:34:53.132Z","avatar_url":"https://github.com/MohamedElashri.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Compiling and testing CI](https://github.com/MohamedElashri/free-mac/actions/workflows/compile.yml/badge.svg)](https://github.com/MohamedElashri/free-mac/actions/workflows/compile.yml)\n\n# Free Command for macOS\n\n## Overview\nThe `free` command is a well-known utility in Linux environments, providing a quick overview of the system's memory usage, including total, used, and free memory, along with swap space information. However, macOS lacks this tool natively. The `free` tool for macOS aims to bridge this gap, offering macOS users a similar functionality to monitor their system's memory usage directly from the command line.\n\n## Installation\n\n### Homebrew\nThe free tool for macOS is available via Homebrew. This is the easiest way to use it. Add this tap to your Homebrew:\n```bash\nbrew tap MohamedElashri/free-mac\n```\nOnce the tap has been added, you can install `free-mac` by running:\n```bash\nbrew install free-mac\n```\n\n### Build from Source\n\n#### Requirements\n- GCC compiler or equivalent\n- macOS system\n  \n#### Compiling\nThe project includes a Makefile for straightforward compilation. There are two targets:\n- `make` for compiling the tool for production use.\n- `make test` for compiling with AddressSanitizer for development and debugging.\n\n##### Release Build\n```bash\nmake\n```\n\n##### Test Build\n```bash\nmake test\n```\n\n#### Running the Tool\nAfter compilation, execute the binary from the terminal to see memory statistics:\n```bash\n./free\n```\n\n##### Cleaning Up\nTo remove the compiled objects and executable:\n```bash\nmake clean\n```\n\n#### Example Output\nRunning the free command outputs the memory and swap usage in a formatted table, similar to the following:\n```\n               total        used        free      shared  buff/cache   available\nMem:       16.00 GB    12.77 GB    26.95 MB     0.00 B     3.20 GB     4.00 GB\nSwap:       2.00 GB   359.94 MB     1.65 GB\n```\n\nWith total flag (`-t`):\n```\n               total        used        free      shared  buff/cache   available\nMem:       16.00 GB    12.77 GB    26.95 MB     0.00 B     3.20 GB     4.00 GB\nSwap:       2.00 GB   359.94 MB     1.65 GB\nTotal:     18.00 GB    13.13 GB     1.68 GB\n```\n\n## Man Page\n\n### NAME\nfree - display amount of free and used memory in the system\n\n### SYNOPSIS\n```bash\nfree [OPTIONS]\n```\n\n### DESCRIPTION\nThe free command provides information about the total amount of physical and swap memory in the system, as well as the free and used memory.\n\n### OPTIONS\n- `-b, --bytes`: Display the amount of memory in bytes.\n- `-k, --kibi`: Display the amount of memory in kibibytes. This is the default.\n- `-m, --mebi`: Display the amount of memory in mebibytes.\n- `-g, --gibi`: Display the amount of memory in gibibytes.\n- `--tebi`: Display the amount of memory in tebibytes.\n- `--pebi`: Display the amount of memory in pebibytes.\n- `--kilo`: Display the amount of memory in kilobytes. Implies --si.\n- `--mega`: Display the amount of memory in megabytes. Implies --si.\n- `--giga`: Display the amount of memory in gigabytes. Implies --si.\n- `--tera`: Display the amount of memory in terabytes. Implies --si.\n- `--peta`: Display the amount of memory in petabytes. Implies --si.\n- `-h, --human`: Show all output fields automatically scaled to shortest three digit unit and display the units.\n- `-w, --wide`: Switch to the wide mode. The wide mode produces lines longer than 80 characters.\n- `-c, --count count`: Display the result count times. Requires the -s option.\n- `-l, --lohi`: Show detailed low and high memory statistics.\n- `-L, --line`: Show output on a single line, often used with the -s option to show memory statistics repeatedly.\n- `-s, --seconds delay`: Continuously display the result delay seconds apart.\n- `--si`: Use kilo, mega, giga etc (power of 1000) instead of kibi, mebi, gibi (power of 1024).\n- `-t, --total`: Display a line showing the column totals.\n- `-v, --committed`: Display a line showing the memory commit limit and amount of committed memory.\n- `-d, --debug`: Enable debug output.\n- `--help`: Print help.\n- `-V, --version`: Display version information.\n\n## License\nThis project is released under the MIT License. See the LICENSE file for more details.\n\n## Contributing\nContributions to the free-mac are welcome! Please feel free to submit pull requests or file issues through GitHub to suggest improvements or report bugs.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohamedelashri%2Ffree-mac","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmohamedelashri%2Ffree-mac","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohamedelashri%2Ffree-mac/lists"}