/Dimface

Automatically dim or brighten Window's screen brightness based on if a face is detected or not.

Primary LanguagePythonMIT LicenseMIT

Dimface

GitHub license Maintenance made-with-python

A command line interface to automatically dim or brighten screen based on if a face is detected on the screen or not to better save battery power.

Requirements

  • Python 3.6+.
  • Windows
    Note: Python must be included in the PATH Environment variable.

Getting Started

  • Clone the repo or click here to download the zip file then extract it locally.
  • Add the cloned repo directory to PATH Environment variable.
  • Open the cloned repo in the terminal and run pip install -r requirements.txt.
  • Run dimface in terminal

Usage

  • Run dimface run --seconds <N> in terminal replacing <N> with the amount of seconds between each frame taken that you want. i.e: 
    dimface run --seconds 2

Personal development

  • Install Make if you're on Windows. OSX already has it installed. Linux will tell you how to install it (i.e., sudo apt-get install make)
  • Install Poetry for managing dependencies or just use python's pip.
    • If you want to disable poetry's venv creation run make venv PY_VENV=false.
    • If you want to add a new dependency run make install DEP_NAME="<name>" and replace <name> with the dependency's name.
    • if you want to export the updated dependencies to a requirements.txt file, run make update-deps.

Acknowledgements