Skip to content

Commit 338d921

Browse files
Update README.md
1 parent ba231e2 commit 338d921

File tree

1 file changed

+92
-0
lines changed

1 file changed

+92
-0
lines changed

README.md

Lines changed: 92 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,94 @@
11
Plex LIFX
22
==========
3+
4+
**plex-lifx** dimms your LIFX light bulb when Plex starts playing. It'll set brightness to 50% when paused and restores original bright when stopped.
5+
6+
A few points:
7+
8+
* plex-lifx is an out of process tool. Meaning it is not a Plex Media Server plug-in. This tool runs separately of your Plex Media Server.
9+
Must be run on the Plex Media Server
10+
* Uses python standard library. Python is the only requirement to run this application
11+
12+
Installation
13+
----
14+
15+
###Linux, OSX
16+
17+
Fetch and install the source from the github repo.
18+
19+
```
20+
git clone https://github.com/cristianmiranda/plex-lifx.git
21+
cd plex-lifx
22+
python setup.py install
23+
```
24+
25+
Alternatively, you can fetch the latest zip from github.
26+
27+
```
28+
wget https://github.com/cristianmiranda/plex-lifx/archive/master.zip
29+
unzip master.zip
30+
cd plex-lifx-master
31+
python setup.py install
32+
```
33+
34+
You're done :smile:
35+
36+
Configuration
37+
-----------
38+
39+
The plex-lifx configuration file (plex_lifx.conf) is installed to ~/.config/plex-lifx/ . The following configuration values are available.
40+
41+
If you're running Plex Media Server on a Linux based operating system, things should work out of the box.
42+
43+
```
44+
[plex-lifx]
45+
# REQUIRED: mediaserver_url is the location of the http service exposed by Plex Media Server. The default values should be 'ok', assuming you're running the plex scrobble script from the same server as your plex media server
46+
mediaserver_url = http://localhost:32400
47+
48+
# REQUIRED: Where do you wish to write the plex-lifx log file.
49+
log_file = /tmp/plex_lifx.log
50+
51+
# REQUIRED: LIFX Personal API token
52+
lifx_token = cb3d4e8f6494e59q09911a63b42ff836df623ad16fd633f101123456789025b5
53+
54+
# REQUIRED: LIFX Light ID
55+
lifx_light_id = f47321245611
56+
57+
# REQUIRED: required only when using authentication even in local networks
58+
# See how to get your token @ https://support.plex.tv/hc/en-us/articles/204059436-Finding-your-account-token-X-Plex-Token
59+
plex_token=E1vy91cJ24yop3iJPq
60+
```
61+
62+
Running
63+
--------
64+
65+
```
66+
$ python plex-lifx.py
67+
```
68+
69+
You may wish to leave the service running in the background. On a POSIX system, wrap the script in the no-hangup utility.
70+
71+
```
72+
$ nohup python plex-lifx.py &
73+
```
74+
75+
Troubleshooting
76+
-------------
77+
78+
For tailing the logs:
79+
```
80+
tail -f /tmp/plex_lifx.log
81+
```
82+
83+
Browse the github issues list to review old bugs or log a new problem. See https://github.com/cristianmiranda/plex-lifx/issues?q=
84+
85+
86+
Contributing
87+
-----------
88+
89+
Please log an issue or a pull request with any fixes.
90+
91+
Thanks
92+
------
93+
94+
Inspired on https://github.com/bstascavage/plexHue

0 commit comments

Comments
 (0)