# Still Alive
[](https://github.com/pythonpioneer/Still-Alive)
[](https://pypi.org/project/still-alive/)
`Still Alive` is a Python package and **command-line tool** designed to keep your system from going idle by simulating mouse movements at specified intervals. Whether you're giving a presentation, monitoring long-running tasks, or simply want to prevent your screen from locking, `Still Alive` can automate mouse movements and ensure your system stays active.
With `Still Alive`, you can customize when the mouse movements begin and end, as well as the frequency of those movements. The tool is command-line friendly and offers flexible configuration options to suit different scenarios.
## Features
- **Simulates Mouse Movements:** The tool makes slight, random mouse movements to prevent system idle.
- **Customizable Timeframes:** Choose specific start and end times, or define durations (in minutes) to control how long the tool runs.
- **Flexible Interval Control:** Specify how often the mouse moves during the active period.
- **Command-Line Interface:** Easily run and configure the tool from the command line, making it simple to automate.
## Installation
To install the package via `pip`, use the following command:
```bash
pip install still-alive
```
This will install the still-alive package, making it available as a command-line tool on your system.
## Usage
The tool provides flexible options to control the start and end times of the mouse movements, as well as the interval between movements.
### Command-Line Arguments:
`Still Alive` offers several command-line arguments to configure its behavior:
- **`--start-duration / -sd:`** Start time in minutes from the current time. Defaults to `0`, meaning it starts immediately unless otherwise specified.
- **`--end-duration / -ed:`** The end time is specified in minutes from the current time. If not provided, it defaults to `60 minutes`, meaning the execution will run for 1 hour.
- **`--start-time / -st:`** Start time in `HH:MM` (24-hour format). If not provided, the tool will either start immediately or after the specified start duration.
- **`--end-time / -et:`** End time in HH:MM (24-hour format). If `--end-duration` is not provided, the execution will default to 1 hour.
- **`--interval / -i:`** Interval between mouse movements, in seconds. The default is `50 seconds`, but you can set any interval that fits your needs.
### How It Works
Once executed, `Still Alive` begins simulating small mouse movements. The movements are very subtle, with slight, random shifts in the mouse’s position. The tool continues these movements at regular intervals (specified by `--interval`), until the defined end time or duration is reached.
### Example Usage
- Move mouse for 2 hours, starting immediately with a 30-second interval between movements:
```bash
still-alive -ed=120 -i=30
```
- Start moving the mouse at 2:00 PM and stop at 6:30 PM:
```bash
still-alive -st=14:00 -et=18:30
```
- Start after 10 minutes, run for 1 hour, with default intervals (50 seconds):
```bash
still-alive -sd=10 -ed=60
```
- Start after 20 minutes, run unitl 4:40 PM, with 2 minutes interval
```bash
still-alive -sd=20 -et=18:40 -i=120
```
- Start moving the mouse for 1 hour, with default interval
```bash
still-alive
```
### Important Notes
- You should specify either the `end-time` (`-et`) or `end-duration` (`-ed`). If neither is provided, it will execute for **1 hour**.
- If `start-time` (`-st`) is not provided, the script will **start immediately** or after the duration specified by `start-duration` (`-sd`).
- If you provide both `start-time` (`-st`) and `start-duration` (`-sd`), then `start-time` (`-st`) takes precedence.
- If you provide both `end-time` (`-et`) and `end-duration` (`-ed`), then `end-time` (`-et`) takes precedence.
## Running in the Background
To ensure that the tool continues running even if the terminal is closed, you can run it in the background using `nohup` (`no hang-up`). This is particularly useful if you want to keep your system active while performing long-running tasks:
```bash
nohup still-alive -et=18:00 --interval=60 &
```
This command will run `Still Alive` until 6:00 PM with an interval of 60 seconds between mouse movements. The process will keep running even if you close the terminal.
### Killing the Process
If you've started `Still Alive` as a background process and want to stop it, follow these steps:
1. Find the process ID (PID):
```bash
ps -aux | grep still-alive
```
This will list the active processes, including `still-alive`. Look for the corresponding PID.
2. Use the PID to kill the process:
```bash
kill <PID>
```
Replace `<PID>` with the process ID of `still-alive`.
## LICENSE
This project is licensed under the `MIT License`, allowing for free use, modification, and distribution under permissive terms.
Raw data
{
"_id": null,
"home_page": "https://github.com/pythonpioneer/Still-Alive",
"name": "still-alive",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": null,
"author": "pythonpioneer",
"author_email": "kumarhritiksinha@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/b7/3e/0b02432a642b0c9cd2946b436eb69515f3e5a0f0f1ebe4d9309c4ed87040/still_alive-1.1.1.tar.gz",
"platform": null,
"description": "# Still Alive\n\n[](https://github.com/pythonpioneer/Still-Alive)\n[](https://pypi.org/project/still-alive/)\n\n`Still Alive` is a Python package and **command-line tool** designed to keep your system from going idle by simulating mouse movements at specified intervals. Whether you're giving a presentation, monitoring long-running tasks, or simply want to prevent your screen from locking, `Still Alive` can automate mouse movements and ensure your system stays active.\n\nWith `Still Alive`, you can customize when the mouse movements begin and end, as well as the frequency of those movements. The tool is command-line friendly and offers flexible configuration options to suit different scenarios.\n\n\n## Features\n\n- **Simulates Mouse Movements:** The tool makes slight, random mouse movements to prevent system idle.\n- **Customizable Timeframes:** Choose specific start and end times, or define durations (in minutes) to control how long the tool runs.\n- **Flexible Interval Control:** Specify how often the mouse moves during the active period.\n- **Command-Line Interface:** Easily run and configure the tool from the command line, making it simple to automate.\n\n## Installation\n\nTo install the package via `pip`, use the following command:\n\n```bash\npip install still-alive\n```\n\nThis will install the still-alive package, making it available as a command-line tool on your system.\n\n## Usage\n\nThe tool provides flexible options to control the start and end times of the mouse movements, as well as the interval between movements.\n\n### Command-Line Arguments:\n\n`Still Alive` offers several command-line arguments to configure its behavior:\n\n- **`--start-duration / -sd:`** Start time in minutes from the current time. Defaults to `0`, meaning it starts immediately unless otherwise specified.\n- **`--end-duration / -ed:`** The end time is specified in minutes from the current time. If not provided, it defaults to `60 minutes`, meaning the execution will run for 1 hour.\n- **`--start-time / -st:`** Start time in `HH:MM` (24-hour format). If not provided, the tool will either start immediately or after the specified start duration.\n- **`--end-time / -et:`** End time in HH:MM (24-hour format). If `--end-duration` is not provided, the execution will default to 1 hour.\n- **`--interval / -i:`** Interval between mouse movements, in seconds. The default is `50 seconds`, but you can set any interval that fits your needs.\n\n### How It Works\n\nOnce executed, `Still Alive` begins simulating small mouse movements. The movements are very subtle, with slight, random shifts in the mouse\u2019s position. The tool continues these movements at regular intervals (specified by `--interval`), until the defined end time or duration is reached.\n\n### Example Usage\n\n- Move mouse for 2 hours, starting immediately with a 30-second interval between movements:\n\n ```bash\n still-alive -ed=120 -i=30\n ```\n\n- Start moving the mouse at 2:00 PM and stop at 6:30 PM:\n\n ```bash\n still-alive -st=14:00 -et=18:30\n ```\n\n- Start after 10 minutes, run for 1 hour, with default intervals (50 seconds):\n\n ```bash\n still-alive -sd=10 -ed=60\n ```\n\n- Start after 20 minutes, run unitl 4:40 PM, with 2 minutes interval\n\n ```bash\n still-alive -sd=20 -et=18:40 -i=120\n ```\n\n- Start moving the mouse for 1 hour, with default interval\n\n ```bash\n still-alive\n ```\n\n### Important Notes\n\n- You should specify either the `end-time` (`-et`) or `end-duration` (`-ed`). If neither is provided, it will execute for **1 hour**.\n- If `start-time` (`-st`) is not provided, the script will **start immediately** or after the duration specified by `start-duration` (`-sd`).\n- If you provide both `start-time` (`-st`) and `start-duration` (`-sd`), then `start-time` (`-st`) takes precedence.\n- If you provide both `end-time` (`-et`) and `end-duration` (`-ed`), then `end-time` (`-et`) takes precedence.\n\n\n## Running in the Background\n\nTo ensure that the tool continues running even if the terminal is closed, you can run it in the background using `nohup` (`no hang-up`). This is particularly useful if you want to keep your system active while performing long-running tasks:\n\n```bash\nnohup still-alive -et=18:00 --interval=60 &\n```\n\nThis command will run `Still Alive` until 6:00 PM with an interval of 60 seconds between mouse movements. The process will keep running even if you close the terminal.\n\n### Killing the Process\n\nIf you've started `Still Alive` as a background process and want to stop it, follow these steps:\n\n1. Find the process ID (PID):\n\n ```bash\n ps -aux | grep still-alive\n ```\n\n This will list the active processes, including `still-alive`. Look for the corresponding PID.\n\n2. Use the PID to kill the process:\n\n ```bash\n kill <PID>\n ```\n\n Replace `<PID>` with the process ID of `still-alive`.\n\n\n## LICENSE\n\nThis project is licensed under the `MIT License`, allowing for free use, modification, and distribution under permissive terms.\n\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "A Command-line tool that moves the mouse slightly at regular intervals",
"version": "1.1.1",
"project_urls": {
"Homepage": "https://github.com/pythonpioneer/Still-Alive"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f307d66e409305448e8643cd1608a04b576338346b391836bec4a51b16737ee8",
"md5": "61fdbb47a3e927b66848ca0d4cd890be",
"sha256": "fd797cee8471f21113ad80a94e7b3708e81fe99f8001763e815e821346f8a9a0"
},
"downloads": -1,
"filename": "still_alive-1.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "61fdbb47a3e927b66848ca0d4cd890be",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 5893,
"upload_time": "2024-09-07T13:58:35",
"upload_time_iso_8601": "2024-09-07T13:58:35.731718Z",
"url": "https://files.pythonhosted.org/packages/f3/07/d66e409305448e8643cd1608a04b576338346b391836bec4a51b16737ee8/still_alive-1.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b73e0b02432a642b0c9cd2946b436eb69515f3e5a0f0f1ebe4d9309c4ed87040",
"md5": "051271cf04414165be5dd932e032e42a",
"sha256": "0f763048d871f519dbe3f8f74e6677fa3a17640997c08a5a76bade63b7086925"
},
"downloads": -1,
"filename": "still_alive-1.1.1.tar.gz",
"has_sig": false,
"md5_digest": "051271cf04414165be5dd932e032e42a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 5514,
"upload_time": "2024-09-07T13:58:37",
"upload_time_iso_8601": "2024-09-07T13:58:37.401657Z",
"url": "https://files.pythonhosted.org/packages/b7/3e/0b02432a642b0c9cd2946b436eb69515f3e5a0f0f1ebe4d9309c4ed87040/still_alive-1.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-07 13:58:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pythonpioneer",
"github_project": "Still-Alive",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "still-alive"
}
JSON
