Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/danialsamadi/free-macos
The Free macOS project offers real-time memory monitoring with interactive progress bars. It uses `Rich` and `Click` to display memory usage in B, KB, MB, or GB, and allows custom refresh intervals.
https://github.com/danialsamadi/free-macos
activity-monitor commands free linux macos memory terminal
Last synced: about 1 month ago
JSON representation
The Free macOS project offers real-time memory monitoring with interactive progress bars. It uses `Rich` and `Click` to display memory usage in B, KB, MB, or GB, and allows custom refresh intervals.
- Host: GitHub
- URL: https://github.com/danialsamadi/free-macos
- Owner: Danialsamadi
- License: mit
- Created: 2024-09-16T01:49:23.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-09-16T20:31:42.000Z (about 2 months ago)
- Last Synced: 2024-10-13T02:22:04.853Z (about 1 month ago)
- Topics: activity-monitor, commands, free, linux, macos, memory, terminal
- Language: Python
- Homepage:
- Size: 9.77 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Free-macos
Have you ever wanted to use the `free` command on macOS? Now you can! The Free macOS project gives you the ability to monitor your system’s memory status with real-time updates and visual progress bars.
But wait, this isn’t just about commands. It’s a live activity monitor for your memory status, implemented with colorful progress bars to give you a clear view of your system’s memory usage.
## Features
- **Live Memory Monitoring:** Visualize memory usage with progress bars.
- **Real-time Updates:** Get up-to-date information about your system’s memory status.
- **Customizable Refresh Interval:** Adjust the interval time between updates using the `--interval` option.
- **Formatted Output:** Memory values are displayed in B, KB, MB, or GB.
- **Easy Setup:** Quickly set up and run the monitoring tool.
## Installation
1. **Clone the Repository**
First, clone the repository to your local machine:
```sh
git clone https://github.com/Danialsamadi/Free-macos.git
2. **Navigate to the Project Directory**
```sh
cd Free-macos
```
3. **Install Dependencies**
Use Poetry to install the project dependencies:
```sh
poetry install
```
## Usage
### Running with Poetry
To run the Free macOS project using Poetry, navigate to the project directory and use the following command:
```sh
poetry run free --interval 2
```
This example sets the refresh interval to 2 seconds. Adjust the interval as needed to suit your preferences.
### Set Up an Alias
To simplify running the project, you can set up an alias in your shell configuration.
Add the following alias to your `.zshrc` or `.bashrc` file, replacing `/path/to/your/project` with the actual path to your project directory:
```sh
alias free="cd /path/to/your/project && poetry run free"
```
After adding the alias, reload your shell configuration:
```sh
source ~/.zshrc
# or
source ~/.bashrc
```
Now you can use the `free` command from anywhere in your terminal to monitor your memory status.
## Contributing
If you want to contribute to the project, feel free to submit a pull request or open an issue. We welcome contributions and feedback!
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.