pyswitcherv2

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 27 Open GitHub ↗

Control your Switcher V2 water heater using Python.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Alt text](https://github.com/sagilo/pyswitcherv2/blob/master/.github/images/switcher.png?raw=true "PySwitcherV2")

# PySwitcherV2
#### Control your Switcher V2 water heater using Python.

## Getting Started
These instructions will get you a copy of the project up and running on your local machine so you can control your Switcher water heater using Python on your local network.

### Prerequisites
The script was tested on Python 2.7 and up or Python 3.5.
Feel free to inform if you find a non compatible version.
You local machine and Switcher must be on the same network.

## Installing
### Using pip

$ pip install pyswitcherv2

### Downloading
Find the latest release at [releases/](https://github.com/sagilo/pyswitcherv2/releases) page

### Cloning
Use the 'clone' button from the repository main page

## Running
### Configuration
The script requires 4 parameters:
* Device ID
* Phone ID
* Device pass
* Switcher local IP address

If you already know these values, edit `credentials.json` accordingly.

Otherwise, you can use the pcap parsing mode to get these parameters

##### Parse pcap file to get credentials:
In order to parse pcap files you will need to install `pypcapfile` package

$ pip install pypcapfile

Then:

$ python switcher.py -m parse_pcap_file -f file.pcap

This will create `credentials.json` file with most of the required information.  
You will still need to update the file with Switcher local IP address (LAN)

If you need assistance in creating pcap file or finding Switcher local ip address, use the [Wiki page tutorial](https://github.com/sagilo/pyswitcherv2/wiki/Capturing-pcap-file-using-Android-device)

### Actions
##### Turn Switcher on/off:

$ python switcher.py -m on

It is possible to use `-t` arg with operation time in minutes (otherwise Switcher will be on for as maximum time as defined in the device settings)

$ python switcher.py -m on -t 45   
 
This will turn on Switcher for 45 minutes

##### Get Switcher state:

$ python switcher.py -m get_state
    
Prints the Switcher state and returns 1 if Switcher is ON and 0 otherwise

### Other
##### Help:

$ python switcher.py -h
    
##### Debug:
In case you are experiencing any issue, please use debug mode to get more information before submitting a ticket.
Debug flag can be used with any other mode

$ python switcher.py -m off -d
    $ python switcher.py -m get_state -d

#### Using as objects
As of version 1.2.9, if you installed via PyPi (pip install..) you should be able to control Switcher as an object within your scripts  
Here is an example use:
```
import time
from pyswitcherv2 import switcher

phone_id = "xxxx"
dev_id = "xxxxxx"
dev_pass = "xxxxxxxx"
switcher_local_ip = "192.168.x.x"

credentials = switcher.Credentials(phone_id, dev_id, dev_pass, switcher_local_ip)
credentials.validate()
is_debug = True
switcher = switcher.Switcher(credentials, is_debug)
time_minutes = 30
switcher.turn_on(time_minutes)
time.sleep(3)
switcher.get_state()
time.sleep(3)
switcher.turn_off()
```

### Wiki
The [Wiki section](https://github.com/sagilo/pyswitcherv2/wiki) contains more information about using the library with HomeAssistant and Homebridge.

pyswitcherv2

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README