Metadata-Version: 2.0
Name: webcon
Version: 0.0.3
Summary: Control your computer from a web interface
Home-page: https://github.com/metakirby5/webcon
Author: Ethan Chan
Author-email: metakirby5@gmail.com
License: MIT
Description-Content-Type: UNKNOWN
Keywords: web controller config yaml
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
Requires-Dist: argcomplete
Requires-Dist: bottle
Requires-Dist: termcolor
Requires-Dist: PyYAML

========
 webcon
========

|Preview|

Control your computer through shell commands from a barebones web interface.

Simple YAML-based configuration.

Installation
------------

::

  pip3 install webcon

Tab completion
--------------

::

  sudo activate-global-python-argcomplete

If you installed via pip, you may need to run the following before autocompletion works:

::

  grep 'PYTHON_ARGCOMPLETE_OK' "$(which webcon)" &>/dev/null || sudo sed -i "1a # PYTHON_ARGCOMPLETE_OK" "$(which webcon)"

Usage
-----

::

  usage: webcon [-h] [--host HOST] [-p PORT] [config_file]

  Control your computer through shell commands from a barebones web interface.

  Configuration goes in ~/.config/webcon/config.yaml, or may be provided by
  command line argument. Variables in `__variables__` will be substituted once via
  `str.format`.

  Example configuration:

  __variables__:
      mpvfifo: ~/.local/share/mpv/fifo
  mpv:
      rewind: echo seek -5 > {mpvfifo}
      play/pause: echo cycle pause > {mpvfifo}
      fast forward: echo seek 5 > {mpvfifo}
  announcer:
      greet: say hello
      part: say farewell

  positional arguments:
    config_file           The config file to use. Default:
                          /Users/echan/.config/webcon/config.yaml

  optional arguments:
    -h, --help            show this help message and exit
    --host HOST           The server host. Default: 0.0.0.0
    -p PORT, --port PORT  The server port. Default: 8080

.. |Preview| image:: https://i.imgur.com/YWVbGoc.png
   :target: https://i.imgur.com/YWVbGoc.png
   :alt: Preview of webcon.


