Metadata-Version: 2.1
Name: philipstv
Version: 2.1.1
Summary: CLI and library to control Philips Android-powered TVs.
Home-page: https://github.com/bcyran/philipstv
License: MIT
Keywords: cli,tv,api-wrapper,philips,ambilight
Author: Bazyli Cyran
Author-email: bazyli@cyran.dev
Requires-Python: >=3.9,<4.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Typing :: Typed
Provides-Extra: cli
Provides-Extra: docs
Requires-Dist: Sphinx (>=7.2.6,<8.0.0) ; extra == "docs"
Requires-Dist: appdirs (>=1.4.4,<2.0.0) ; extra == "cli"
Requires-Dist: click (>=8.0.3,<9.0.0) ; extra == "cli"
Requires-Dist: enum-tools[sphinx] (>=0.12.0,<0.13.0) ; extra == "docs"
Requires-Dist: furo (>=2024.1.29,<2025.0.0) ; extra == "docs"
Requires-Dist: pydantic (>=2.4.2,<3.0.0)
Requires-Dist: requests (>=2.27.1,<3.0.0)
Project-URL: Documentation, https://philipstv.readthedocs.io
Project-URL: Repository, https://github.com/bcyran/philipstv
Description-Content-Type: text/x-rst

philipstv
=========

.. image:: https://github.com/bcyran/philipstv/workflows/CI/badge.svg?event=push
   :target: https://github.com/bcyran/philipstv/actions?query=event%3Apush+branch%3Amaster+workflow%3ACI
   :alt: CI

.. image:: https://codecov.io/gh/bcyran/philipstv/branch/master/graph/badge.svg?token=ROJONX34RB
   :target: https://codecov.io/gh/bcyran/philipstv
   :alt: codecov

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
   :target: https://github.com/psf/black
   :alt: Code style: black

.. image:: https://img.shields.io/pypi/v/philipstv
   :target: https://pypi.org/project/philipstv/
   :alt: pypi

.. image:: https://readthedocs.org/projects/philipstv/badge/?version=stable
   :target: https://philipstv.readthedocs.io/en/stable/?badge=stable
   :alt: Documentation status

.. image:: https://img.shields.io/pypi/pyversions/philipstv
   :target: https://pypi.org/project/philipstv/
   :alt: versions

.. image:: https://img.shields.io/github/license/bcyran/philipstv
   :target: https://github.com/bcyran/philipstv/blob/master/LICENSE
   :alt: license

.. -begin-intro-

Python package providing CLI and library for interacting with Philips Android-powered TVs.

Features:

- Get and set TV power state.
- Get and set volume.
- List and change TV channels.
- Emulate pressing remote keys.
- Get and set Ambilight power state.
- Get and set Ambilight color.
- List and launch applications.

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

PyPI
^^^^

If you plan to use the CLI:

.. code-block:: console

   $ pip install 'philipstv[cli]'

If you only need library for use in Python code:

.. code-block:: console

   $ pip install philipstv

.. -end-intro-

Arch Linux (AUR)
^^^^^^^^^^^^^^^^

`philipstv AUR package <https://aur.archlinux.org/packages/philipstv>`_ is available.


Documentation
-------------
See full documentation: `Read the Docs: philipstv <https://philipstv.readthedocs.io>`_.

See also
--------
- `PhilipsTV GUI <https://github.com/bcyran/philipstv-gui>`_ - GUI application built with this library.

Resources
---------
- `Fantastic unofficial API documentation <https://github.com/eslavnov/pylips/blob/master/docs/Home.md>`_ and `script <https://github.com/eslavnov/pylips>`_ by `@eslavnov <https://github.com/eslavnov>`_.
- Philips `JointSpace API documentation <http://jointspace.sourceforge.net/projectdata/documentation/jasonApi/1/doc/API.html>`_.

