{"id":13753410,"url":"https://github.com/McMuellermilch/macStats","last_synced_at":"2025-05-09T21:34:48.227Z","repository":{"id":188004800,"uuid":"271342942","full_name":"McMuellermilch/macStats","owner":"McMuellermilch","description":"A simple macOS menu bar app, that displays all the relevant info about your Mac","archived":false,"fork":false,"pushed_at":"2020-06-18T09:04:20.000Z","size":4372,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-11-16T06:30:20.408Z","etag":null,"topics":["macos","pipenv","python","stats"],"latest_commit_sha":null,"homepage":"","language":"Python","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/McMuellermilch.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}},"created_at":"2020-06-10T17:33:26.000Z","updated_at":"2024-02-12T09:01:36.000Z","dependencies_parsed_at":"2023-08-13T08:49:28.660Z","dependency_job_id":null,"html_url":"https://github.com/McMuellermilch/macStats","commit_stats":null,"previous_names":["mcmuellermilch/macstats"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/McMuellermilch%2FmacStats","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/McMuellermilch%2FmacStats/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/McMuellermilch%2FmacStats/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/McMuellermilch%2FmacStats/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/McMuellermilch","download_url":"https://codeload.github.com/McMuellermilch/macStats/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253328853,"owners_count":21891538,"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":["macos","pipenv","python","stats"],"created_at":"2024-08-03T09:01:21.634Z","updated_at":"2025-05-09T21:34:47.256Z","avatar_url":"https://github.com/McMuellermilch.png","language":"Python","funding_links":[],"categories":["System Status"],"sub_categories":["Local System Status"],"readme":"# macStats\n\n\u003cimg src=\"resources/app_icon.png\" alt=\"logo\" width=\"100\" height=\"100\"\u003e\n\n[![made-with-python](https://img.shields.io/badge/Made%20with-Python-1f425f.svg)](https://www.python.org/) [![GitHub license](https://img.shields.io/github/license/Naereen/StrapDown.js.svg)](https://github.com/McMuellermilch/macStats/blob/master/LICENSE)\n\nA simple macOS menu bar app, that displays all the relevant info about your Mac - built on top of [rumps](https://github.com/jaredks/rumps)\n\n## Getting started\n\n### Screenshots\n\n\u003cimg src=\"resources/screenshot_online.png\" alt=\"screenshot_online\" height=\"350\"\u003e \u003cimg src=\"resources/screenshot_offline.png\" alt=\"screenshot_offline\" height=\"350\"\u003e\n\u003cbr/\u003e\n\n### Installing\n\nmacStats can be downloaded as a bundled .app file. [Here](https://github.com/McMuellermilch/macStats/releases) you can download the zipped file.\n\nAfter downloading and unzipping, just copy macStats.app into your Applications folder.\n\nTo have macStats automatically start at startup, just head over to `Settings -\u003e Users \u0026 Groups -\u003e Login Terms`, click the `+` and select macStats.\n\n### Development\n\n#### Prerequisites\n\nmacStats only runs on `macOS`. Furthermore, you need an installation of `Python3` on your machine.\n\n#### Dependencies\n\nPackagemanagement for this project has been done with [pipenv](https://github.com/pypa/pipenv). With pipenv installed, you only have to run `pipenv install` to install all dependencies from the `Pipfile`. To start up the virtual environment, just run `pipenv shell`.\n\nWithout pipenv, install the dependencies as follows:\n\n```python\npip install rumps py2app netifaces psutil\n```\n\n#### Building the app\n\nAt root level of the project directory, you can build the app with the following command:\n\n```python\npython3 setup.py py2app\n```\n\nThis will create two new folders in the directory: `build` and `dist`. The bundled application can be found in `./dist/macStats.app`.\n\nAfter building, you can start macStats by running:\n\n```python\n./dist/macStats.app/Contents/MacOS/macStats\n```\n\n## Usage\n\nThe idea behind macStats is to bundle all the necessary info about your Mac in one place and with that, replacing an abundance of terminal commands, settings pages and other apps. It's mainly for displaying information, so there's not much interactivity to it.\n\nAs an easy to see indicator for network connectivity, the logo in the app bar will change colors depending on the network connection status.\n\n\u003cimg src=\"resources/logo_colorchange.gif\" alt=\"screencast_colorchange\"\u003e\n\nThe only button - `Copy stats to clipboard` - will copy a string to your clipboard, that contains the following data:\n\n```\nModel: -\nProcessor: -\nmacOS: -\nMAC-address: -\nRAM: -GB\nInternet-connection: True/False\n\n```\n\nThis button is meant to make aksing questions online about your Mac easier. When searching for a solution to a certain problem, it is of utmost importance to give all the relevant information and context for people to be able to solve your problem. Well, the info about your hardware is taken care of.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMcMuellermilch%2FmacStats","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMcMuellermilch%2FmacStats","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMcMuellermilch%2FmacStats/lists"}