volumouse


Namevolumouse JSON
Version 0.0.9 PyPI version JSON
download
home_page
SummaryA Python 3 program that allows you to change the volume with the mouse wheel using it at the four corners of the screen.
upload_time2023-03-15 16:55:49
maintainer
docs_urlNone
author
requires_python>=3.7
license
keywords volume mouse screen
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            # volumouse
[DEPRECATED] This project works well, but unfortunately it is impossible to autostart volumouse when the computer starts, so it's useless. Use the GitHub project instead : [GitHub Volumouse](https://github.com/pzim-devdata/volumouse)

 A Python 3 program that allows you to change the volume with the mouse wheel using it at the four corners of the screen. 
Run in a terminal `volumouse -c` to configure and execute it with `volumouse` command


<p align="center" width="100%">
    <img width="33%" src="https://www.evinco-software.com/eng/techImage/volumouse-mouse-volume-control.jpg"> 
</p>


# Install the main package :


1. Install dependancies :

You need x11-utils :
Debian, Ubuntu, Kali Linux, Raspbian :`apt-get install x11-utils`
Arch Linux :`pacman -S xorg-xdpyinfo`
CentOS : `yum install xorg-x11-utils`
Fedora : `dnf install xorg-x11-utils`

You also need pulseaudio-utils :
Debian, Ubuntu, Kali Linux, Raspbian : `apt-get install pulseaudio-utils`
Alpine : `apk add pulseaudio-utils`
Arch Linux : `pacman -S libpulse`
CentOS : `yum install pulseaudio-utils`
Fedora : `dnf install pulseaudio-utils`


2. Install volumouse :

#########################################

On the next version of Python and Linux you will need to install in this way (using virtual env) :

```
sudo apt install pipx
pipx install volumouse
```
To update volumouse to the latest version :
`pipx upgrade volumouse`

If volumouse has been installed in ~/.local/bin you will need to add this file to the PATH : ~/.local/bin (if it's not already done) :

`sudo echo 'export PATH=$PATH:~/.local/bin' >> ~/.bashrc`

[How to create a PATH on Linux ?](https://linuxize.com/post/how-to-add-directory-to-path-in-linux/)

#########################################

Normal way to install on Linux :

```
sudo python3 -m pip install -U volumouse
```

!!! It's very important to use the `sudo` command because like this volumouse will be in the PATH


# Configure :


It's very easy to configure, there are just a simple command to execute, once for all, the first time :

All is explained in volumouse --help and volumouse --info

(`sudo` command is required if you have installed volumouse with the `sudo` command) :

Open a terminal and type :
- `sudo volumouse --configure` or `sudo volumouse -c`



# Usage : 


Just run the command `volumouse` in a terminal or, for starting volumouse at startup (Enter `which volumouse` in a terminal to know the installed directory of volumouse. Then as startup parameters,enter this command : `sh -c 'result_of_which_command'`. For instance : `sh -c '~/.local/bin/volumouse'`)



# Create a PATH to volumouse :


If you have installed volumouse without the `sudo` command on Linux you will need to create a PATH for starting volumouse with the `volumouse` command.

Indead, to be able to run volumouse directly in the terminal, without going to the source package, you should add the volumouse's folder to the PATH :

On Linux, it can be permanently done by executing : `sudo gedit ~/.bashrc` and adding, at the end of the document, this line :

`export PATH=$PATH:/place/of/the/folder/volumouse`



If you want to temporarily test it before, you can just execute this command in the terminal : 

`export PATH=$PATH:/place/of/the/folder/volumouse` 

It will be restored on the next reboot.



By doing this, instead of taping `python3 '/place/of/the/folder/volumouse/volumouse.py'`,
you will be able to directly tape in the terminal : `volumouse`.






[@pzim-devdata GitHub Pages](https://github.com/pzim-devdata/volumouse/issues)












<p align="center" width="100%">
    <img width="33%" src="https://avatars.githubusercontent.com/u/52496172?v=4"> 
</p>

------------------------------------------------------------------

- [Licence](https://github.com/pzim-devdata/DATA-developer/raw/master/LICENSE)
MIT License Copyright (c) 2023 pzim-devdata

------------------------------------------------------------------

Created by @pzim-devdata - feel free to contact me!

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "volumouse",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": "",
    "keywords": "volume,mouse,screen",
    "author": "",
    "author_email": "Pzim-devdata <contact@pzim.fr>",
    "download_url": "https://files.pythonhosted.org/packages/a1/05/205be9fff905028517d425776f87d6367e990cb258b9e28d4ef53ec7c4d8/volumouse-0.0.9.tar.gz",
    "platform": null,
    "description": "# volumouse\n[DEPRECATED] This project works well, but unfortunately it is impossible to autostart volumouse when the computer starts, so it's useless. Use the GitHub project instead : [GitHub Volumouse](https://github.com/pzim-devdata/volumouse)\n\n A Python 3 program that allows you to change the volume with the mouse wheel using it at the four corners of the screen. \nRun in a terminal `volumouse -c` to configure and execute it with `volumouse` command\n\n\n<p align=\"center\" width=\"100%\">\n    <img width=\"33%\" src=\"https://www.evinco-software.com/eng/techImage/volumouse-mouse-volume-control.jpg\"> \n</p>\n\n\n# Install the main package :\n\n\n1. Install dependancies :\n\nYou need x11-utils :\nDebian, Ubuntu, Kali Linux, Raspbian :`apt-get install x11-utils`\nArch Linux :`pacman -S xorg-xdpyinfo`\nCentOS : `yum install xorg-x11-utils`\nFedora : `dnf install xorg-x11-utils`\n\nYou also need pulseaudio-utils :\nDebian, Ubuntu, Kali Linux, Raspbian : `apt-get install pulseaudio-utils`\nAlpine : `apk add pulseaudio-utils`\nArch Linux : `pacman -S libpulse`\nCentOS : `yum install pulseaudio-utils`\nFedora : `dnf install pulseaudio-utils`\n\n\n2. Install volumouse :\n\n#########################################\n\nOn the next version of Python and Linux you will need to install in this way (using virtual env) :\n\n```\nsudo apt install pipx\npipx install volumouse\n```\nTo update volumouse to the latest version :\n`pipx upgrade volumouse`\n\nIf volumouse has been installed in ~/.local/bin you will need to add this file to the PATH : ~/.local/bin (if it's not already done) :\n\n`sudo echo 'export PATH=$PATH:~/.local/bin' >> ~/.bashrc`\n\n[How to create a PATH on Linux ?](https://linuxize.com/post/how-to-add-directory-to-path-in-linux/)\n\n#########################################\n\nNormal way to install on Linux :\n\n```\nsudo python3 -m pip install -U volumouse\n```\n\n!!! It's very important to use the `sudo` command because like this volumouse will be in the PATH\n\n\n# Configure :\n\n\nIt's very easy to configure, there are just a simple command to execute, once for all, the first time :\n\nAll is explained in volumouse --help and volumouse --info\n\n(`sudo` command is required if you have installed volumouse with the `sudo` command) :\n\nOpen a terminal and type :\n- `sudo volumouse --configure` or `sudo volumouse -c`\n\n\n\n# Usage : \n\n\nJust run the command `volumouse` in a terminal or, for starting volumouse at startup (Enter `which volumouse` in a terminal to know the installed directory of volumouse. Then as startup parameters,enter this command : `sh -c 'result_of_which_command'`. For instance : `sh -c '~/.local/bin/volumouse'`)\n\n\n\n# Create a PATH to volumouse :\n\n\nIf you have installed volumouse without the `sudo` command on Linux you will need to create a PATH for starting volumouse with the `volumouse` command.\n\nIndead, to be able to run volumouse directly in the terminal, without going to the source package, you should add the volumouse's folder to the PATH :\n\nOn Linux, it can be permanently done by executing : `sudo gedit ~/.bashrc` and adding, at the end of the document, this line :\n\n`export PATH=$PATH:/place/of/the/folder/volumouse`\n\n\n\nIf you want to temporarily test it before, you can just execute this command in the terminal : \n\n`export PATH=$PATH:/place/of/the/folder/volumouse` \n\nIt will be restored on the next reboot.\n\n\n\nBy doing this, instead of taping `python3 '/place/of/the/folder/volumouse/volumouse.py'`,\nyou will be able to directly tape in the terminal : `volumouse`.\n\n\n\n\n\n\n[@pzim-devdata GitHub Pages](https://github.com/pzim-devdata/volumouse/issues)\n\n\n\n\n\n\n\n\n\n\n\n\n<p align=\"center\" width=\"100%\">\n    <img width=\"33%\" src=\"https://avatars.githubusercontent.com/u/52496172?v=4\"> \n</p>\n\n------------------------------------------------------------------\n\n- [Licence](https://github.com/pzim-devdata/DATA-developer/raw/master/LICENSE)\nMIT License Copyright (c) 2023 pzim-devdata\n\n------------------------------------------------------------------\n\nCreated by @pzim-devdata - feel free to contact me!\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "A Python 3 program that allows you to change the volume with the mouse wheel using it at the four corners of the screen.",
    "version": "0.0.9",
    "split_keywords": [
        "volume",
        "mouse",
        "screen"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "bd41a9adc262c34148c0cda8352785b9addf6638871816d21cc1d5e22647aad6",
                "md5": "6fe976d53ad6c6e681277915c2502984",
                "sha256": "8433c9133bfe018bae9dabf83af5b4d4be06bc9200bdb3d8be3081ad6e794497"
            },
            "downloads": -1,
            "filename": "volumouse-0.0.9-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "6fe976d53ad6c6e681277915c2502984",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 9191,
            "upload_time": "2023-03-15T16:55:48",
            "upload_time_iso_8601": "2023-03-15T16:55:48.124625Z",
            "url": "https://files.pythonhosted.org/packages/bd/41/a9adc262c34148c0cda8352785b9addf6638871816d21cc1d5e22647aad6/volumouse-0.0.9-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "a105205be9fff905028517d425776f87d6367e990cb258b9e28d4ef53ec7c4d8",
                "md5": "88486d007980a2fd2d05f9cf26737c7a",
                "sha256": "a6362ae5ed8fbdc0d3e09dfe979a0fdbc5098e065f5a948235ad1904d9e05b28"
            },
            "downloads": -1,
            "filename": "volumouse-0.0.9.tar.gz",
            "has_sig": false,
            "md5_digest": "88486d007980a2fd2d05f9cf26737c7a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 10266,
            "upload_time": "2023-03-15T16:55:49",
            "upload_time_iso_8601": "2023-03-15T16:55:49.871462Z",
            "url": "https://files.pythonhosted.org/packages/a1/05/205be9fff905028517d425776f87d6367e990cb258b9e28d4ef53ec7c4d8/volumouse-0.0.9.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-03-15 16:55:49",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "lcname": "volumouse"
}
Elapsed time: 0.04715s