Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/tushar-rishav/balert

:loudspeaker: For lazy programmers!
https://github.com/tushar-rishav/balert

Last synced: 3 months ago
JSON representation

:loudspeaker: For lazy programmers!

Host: GitHub
URL: https://github.com/tushar-rishav/balert
Owner: tushar-rishav
License: lgpl-3.0
Created: 2015-08-08T07:06:21.000Z (over 9 years ago)
Default Branch: master
Last Pushed: 2016-07-19T10:13:59.000Z (over 8 years ago)
Last Synced: 2024-09-14T01:56:07.916Z (4 months ago)
Language: Python
Homepage:
Size: 63.5 KB
Stars: 17
Watchers: 2
Forks: 2
Open Issues: 0
Metadata Files:
- Readme: README
- License: LICENSE.txt

Awesome Lists containing this project

README

        Balert :loudspeaker:

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

Balert is for all the lazy people (like me :bowtie: ) who often miss

desktop notifications. Balert will say it clear and loud whenever your

battery status goes below a default critical level or the level decided

by you!

\| Build Status \| Version \| Downloads \| Python \| \| ------------

\|---------\|-----------\|----------\| \| |Build Status|\ \|\ |PyPI

version|\ \| |PyPi downloads|\ \|\ |PyPI| ###

`Demo `__

|balert|

Installation

~~~~~~~~~~~~

Build from tar files

''''''''''''''''''''

.. code:: sh

        wget "https://pypi.python.org/packages/source/B/Balert/Balert-1.1.8.tar.gz"

        tar xzvf Balert-1.1.8.tar.gz

        cd Balert-1.1.8

        python setup.py install

Build from source

'''''''''''''''''

.. code:: sh

        git clone https://github.com/tushar-rishav/balert.git Balert

        cd Balert

        python setup.py install

Using pip

'''''''''

.. code:: sh

        pip install Balert

After installation is done successfully, run any combinations of below

command in your terminal once for initial setup and then we are done! If

you want to use the default setup then just run ``balert`` in terminal.

Default config:

~~~~~~~~~~~~~~~

::

    language: English

    rate    : 150

    charge  : 20 (in percentage)

    msg     : ""

    vol     : 1.0

Options

~~~~~~~

.. code:: sh

    usage: main.py [-h] [-r RATE] [-v VOL] [-l LANG] [-m MSG] [-c CHARGE] [-s]

    Listen the voice of your battery whenever she is low!

    optional arguments:

      -h, --help            show this help message and exit

      -r RATE, --rate RATE  Rate of speaking.(100-200)

      -v VOL, --vol VOL     Volume of speaking.(1.0)

      -l LANG, --lang LANG  Language speaking

      -m MSG, --msg MSG     Alert message of your own

      -c CHARGE, --charge CHARGE

                            Decide the critical charge level

      -s, --show            Show the currently set config

Usage

~~~~~

Set language

''''''''''''

To set the language eg. hindi, english , tamil. Default one is english

.. code:: sh

    balert -l hindi

Set rate of speaking

''''''''''''''''''''

.. code:: sh

    balert -r 100

Set your custom alert message

'''''''''''''''''''''''''''''

.. code:: sh

    balert -m "Delta is the state of mind"

Set custom charge level.

''''''''''''''''''''''''

If the battery level is below this critical level then it will give

voice alert

.. code:: sh

    balert -c 30

View the set configuration

''''''''''''''''''''''''''

.. code:: sh

    balert -s

Get help

''''''''

.. code:: sh

    balert -h

Example

'''''''

.. code:: sh

    balert -m "Hey,Lazy dog " -c 25

When you run the above code, you've set "Hey,Lazy dog" as your custom

message and 25 as your critical charge level.

Contributions

~~~~~~~~~~~~~

Have an idea to make it better? Go ahead! I will be happy to see a pull

request from you! :blush:

License

~~~~~~~

.. figure:: https://cloud.githubusercontent.com/assets/7397433/9025904/67008062-3936-11e5-8803-e5b164a0dfc0.png

   :alt: gpl

.. |Build Status| image:: https://travis-ci.org/tushar-rishav/balert.svg?branch=master

   :target: https://travis-ci.org/tushar-rishav/balert

.. |PyPI version| image:: https://badge.fury.io/py/balert.svg

   :target: http://badge.fury.io/py/balert

.. |PyPi downloads| image:: https://img.shields.io/pypi/dm/Balert.svg

   :target: https://pypi.python.org/pypi/Balert

.. |PyPI| image:: https://img.shields.io/pypi/pyversions/Balert.svg

   :target: https://pypi.python.org/pypi/Balert

.. |balert| image:: https://cloud.githubusercontent.com/assets/7397433/9695992/263ad662-5386-11e5-9066-e1714fb2aa0b.gif