{"id":13419453,"url":"https://github.com/darxtrix/ptop","last_synced_at":"2025-03-15T05:31:16.663Z","repository":{"id":34600028,"uuid":"38547811","full_name":"darxtrix/ptop","owner":"darxtrix","description":"An awesome task manager written in python.  :computer:","archived":false,"fork":false,"pushed_at":"2022-12-08T01:17:47.000Z","size":9573,"stargazers_count":576,"open_issues_count":28,"forks_count":43,"subscribers_count":18,"default_branch":"master","last_synced_at":"2024-08-30T23:55:08.219Z","etag":null,"topics":["linux","macos","npyscreen","ptop","python","task-manager","terminal-app"],"latest_commit_sha":null,"homepage":"http://darxtrix.in/ptop/","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/darxtrix.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}},"created_at":"2015-07-04T21:11:51.000Z","updated_at":"2024-07-14T08:47:34.000Z","dependencies_parsed_at":"2023-01-15T08:01:11.058Z","dependency_job_id":null,"html_url":"https://github.com/darxtrix/ptop","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darxtrix%2Fptop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darxtrix%2Fptop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darxtrix%2Fptop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darxtrix%2Fptop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/darxtrix","download_url":"https://codeload.github.com/darxtrix/ptop/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243690114,"owners_count":20331726,"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":["linux","macos","npyscreen","ptop","python","task-manager","terminal-app"],"created_at":"2024-07-30T22:01:16.259Z","updated_at":"2025-03-15T05:31:16.308Z","avatar_url":"https://github.com/darxtrix.png","language":"Python","readme":"# ptop\n\nAn awesome task manager written in python. A more awesome top like thing in your terminal !\n\n\n![ptop-image](https://github.com/darxtrix/ptop/blob/master/docs/ptop_demo.gif)\n\n\n\u003e Inspired by [vtop](https://github.com/MrRio/vtop)\n\n\n## Some Screenshots\n\n\u003cimg src=\"https://github.com/darxtrix/ptop/blob/master/docs/ptop_01.png\" alt=\"ptop usage 01\"/\u003e\n\u003cimg src=\"https://github.com/darxtrix/ptop/blob/master/docs/ptop_02.png\" alt=\"ptop usage 02\" /\u003e\n\n\n## Installation\n\n`ptop` is compaible with both Python2.x and Python3.x and is tested on Linux and MaxOSx (should be invoked as root) environments.\n\n```bash\n$ pip install ptop\n```\n\nor\n\n```bash\n$  git clone https://github.com/darxtrix/ptop\n$ cd ptop/\n$ pip install -r requirements.txt # install requirements\n$ sudo python setup.py install\n```\n\n\n## Upgrading ptop\n\nThe latest version is 1.0. Older versions of `ptop` can be updated using:\n```bash\n$ pip install --upgrade ptop\n```\n\nCheckout this blog post for more on the latest developments https://medium.com/@darxtrix/releasing-ptop-1-0-a-task-manager-written-using-python-879f63745034\n\n\n## Usage\n\n```bash\n$ ptop\n\n$ ptop -t \u003ctheme\u003e   # custom theme\n\n$ ptop -csrt 500    # custom refresh time for cpu stats \n\n$ ptop -h           # help\n```\n\n## Features\n\n- Killing a process :heavy_check_mark:\n- Showing system ports and files used by a process :heavy_check_mark:\n- Network Monitor :heavy_check_mark:\n- Process search :heavy_check_mark:\n- Sorting on the basis of process lifetime and memory used :heavy_check_mark:\n- Responsiveness with terminal :heavy_check_mark:\n- Custom refresh times for different stats like memory info, process info etc :heavy_check_mark:\n- Rolling version updates :heavy_check_mark:\n\nFor suggesting new features please add to this [issue](https://github.com/darxtrix/ptop/issues/29)\n\n\n## Supported themes\n\n- `colorful`     \n- `elegant`    \n- `simple`    \n- `dark`   \n- `light` \n\n\n## Developing ptop\n\n```bash\n$ git clone https://github.com/darxtrix/ptop\n$ cd ptop   \n$ pip install -r requirements.txt\n$ python setup.py develop\n```\n**Note :** ptop will create a log file called `.ptop.log` in the home directory of the user.\n\n\n## Contributions Guide\n\n- Pull requests are awesome and always welcome. Please use the [issue tracker](https://github.com/darxtrix/ptop/issues) to report any bugs.\n- For starters, we have filtered some [newbie issues](https://github.com/darxtrix/ptop/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22).\n- Feel free to shoot your queries at the ptop [gitter](https://gitter.im/ptop_task_manager/Lobby) channel.\n\n\n## Main modules :\n\n- `ptop.core` : Defines a basic `Plugin` class that other plugins in the `ptop.plugins` inherit.\n- `ptop.interfaces` : The interface to the ptop built using npyscreen.\n- `ptop.plugins` : This module contains all the plugin sensors supported i.e `Disk Sensor`,`Memory Sensor`,`Process Sensor`, etc. ( Any new plugin should be added here).\n- `ptop.statistics` : Generate continuous statistics using background thread jobs by locating plugins in the plugins directory.\n- `ptop.utils` : Custom thread classes.\n\n\n## Main Dependencies\n\n- [npyscreen](https://pypi.python.org/pypi/npyscreen)\n- [psutil](https://pypi.python.org/pypi/psutil)\n- [drawille](https://github.com/asciimoo/drawille)\n\n## Contributors \n\n* **[vinusankars](https://github.com/vinusankars)**\n* **[Deepak Narayanan](https://github.com/deeps-nars)**\n* **[Smeet Vora](https://github.com/smeet20)**\n* **[Santiago Castro](https://github.com/bryant1410)**\n* **[Yu-Jie Lin](https://github.com/livibetter)**\n\nFor details please check [Contributors.md](https://github.com/darxtrix/ptop/blob/master/CONTRIBUTORS.md)\n\n## License \n\nMIT © [Ankush Sharma](http://github.com/darxtrix)\n","funding_links":[],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarxtrix%2Fptop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdarxtrix%2Fptop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarxtrix%2Fptop/lists"}