Package: weconnect-cli
WeConnect-cliCommandline Interface to interact with the Volkswagen WeConnect ServicesWhat is the purpose?If you want to query data from weconnect you can use this command line interface to query the service. This commandline interface behaves like a user using the WeConnect ID App and the WeConnect secion on myvolkswagen.de. Use this if you want to work with the data from WeConnect.RequirementsYou need to install python 3 on your system:How to install python. The minimum required python version is 3.8Login & ConsentWeConnect-cli is based on the new WeConnect API that was introduced with the new series of ID cars. If you use another car or hybrid you probably need to agree to the terms and conditions of the new WeConnect interface. Easiest to do so is by installing the Volkswagen app on your smartphone and login there. If necessary you will be asked to agree to the terms and conditions.How to installIf you want to use WeConnect-cli, the easiest way is to obtain it fromPyPI. Just install instead using:pip3installweconnect-cliUpdatesIf you want to update WeConnect-cli, the easiest way is:pip3installweconnect-cli--upgradeHow to useStart weconnect-cli from the commandline, by default you will enter the interactive shell:weconnect-cli--usernameuser@mail.de--passwordtest123You get all the usage information by using the --help commandweconnect-cli--helpWith the "list" command you can get a list of all available information you can query (use "list -s" if you want to see which attributes can be changed)weconnect-cli--usernameuser@mail.de--passwordtest123list
/vehicles/WVWABCE1ZSD057394
/vehicles/WVWABCE1ZSD057394/vin
/vehicles/WVWABCE1ZSD057394/role
/vehicles/WVWABCE1ZSD057394/enrollmentStatus
/vehicles/WVWABCE1ZSD057394/model
/vehicles/WVWABCE1ZSD057394/nickname
/vehicles/WVWABCE1ZSD057394/capabilities
...You can then pass the addresses to the "get" command:weconnect-cli--usernameuser@mail.de--passwordtest123get/vehicles/WVWABCE1ZSD057394/model
ID.3or the "set" command:weconnect-cli--usernameuser@mail.de--passwordtest123set/vehicles/WVWABCE1ZSD057394/controls/climatisationstopThe "events" command allows you to monitor what is happening on the WeConnect Interface:weconnect-cli--usernameuser@mail.de--passwordtest123events2021-05-2616:49:58.698570:/vehicles/WVWABCE1ZSD057394/access/accessStatus/overallStatus:newvalue:unsafe2021-05-2616:49:58.698751:/vehicles/WVWABCE1ZSD057394/access/accessStatus/doors/bonnet/lockState:newvalue:unknownlockstate2021-05-2616:49:58.698800:/vehicles/WVWABCE1ZSD057394/access/accessStatus/doors/bonnet/openState:newvalue:closed2021-05-2616:49:58.698980:/vehicles/WVWABCE1ZSD057394/access/accessStatus/doors/frontLeft/lockState:newvalue:unlocked2021-05-2616:49:58.699056:/vehicles/WVWABCE1ZSD057394/access/accessStatus/doors/frontLeft/openState:newvalue:closedS-PINFor some commands (e.g. locking/unlocking supported on some cars) you need in addition to your login the so called S-PIN, you can provide it with the-soption:weconnect-cli--usernameuser@mail.de--passwordtest123-s1234set/vehicles/WVWABCE1ZSD057394/controls/accesslockCharging StationsTo obtain data for charging stations you have to add a location to search for in geo coordinates and a search radius in meters:weconnect-cli--chargingLocation52.43713210.796628--chargingLocationRadius=500get/chargingStations
ID:40a4b8d3-d534-422c-9cd8-81bbfa5b578f
Name:VWGroupOebisfelderStraßeParkhausOst
Operator:VWGroup(Id:edd03be9-2df7-4fe3-be32-1573ba91aac0)Latitude:52.4370178
Longitude:10.7977292
Distance:76m
Address:OebisfelderStraße1,38448Wolfsburg,Deutschland
Max.ChargingPower:50.0kW
ChargingSpots:2itemsAvailability:OCCUPIEDMax.ChargingPower:22.0kWConnectors:1itemsPlugType:Type2Max.ChargingPower:22.0kWAvailability:AVAILABLEMax.ChargingPower:50.0kWConnectors:1itemsPlugType:CCSMax.ChargingPower:50.0kW

Authentification:RFID,APP,UNKNOWN,UNKNOWN
Options:weChargepartner;Interactive ShellYou can also use an interactive shell:weconnect-cli --username user@mail.de --password test123 shell
Welcome! Type ? to list commands
user@mail.de@weconnect-sh:/$update
update done
user@mail.de@weconnect-sh:/$cd vehicles
user@mail.de@weconnect-sh:/vehicles$ ls
..
WVWABCE1ZSD057394
WVWABCE13SD057505
user@mail.de@weconnect-sh:/vehicles$ cd /vehicles/WVWABCE13SD057505/status/parkingPosition
user@mail.de@weconnect-sh:/vehicles/WVWABCE13SD057505/status/parkingPosition$ cat
[parkingPosition] (last captured 2021-06-01T19:05:04+00:00)
	Latitude: 51.674535
	Longitude: 16.154376
user@mail.de@weconnect-sh:/vehicles/WVWABCE13SD057505/parking/parkingPosition$ exit
ByeCachingBy default weconnect-cli will cache (store) the data for 300 seconds before retrieving new data from the servers. This makes weconnect-cli more responsive and at the same time does not cause unneccessary requests to the vw servers. If you want to increase the cache duration use --interval option. If you do not want to cache use --no-cache option. Please use the no-cache option with care. You are generating traffic with subsequent requests.CredentialsIf you do not want to provide your username or password all the time you have to create a ".netrc" file at the appropriate location (usually this is your home folder):machine volkswagen.de
login test@test.de
password testpassword123You can also provide the location of the netrc file using the --netrc optionThe optional S-PIN needed for some commands can be provided in the account section:# For WeConnect
machine volkswagen.de
login test@test.de
password testpassword123
account 1234ImagesYou can also work with images from the API
Either you have a look at the commandlineweconnect-cli get /vehicles/WVWABCE13SD057505/pictures/car
                                     zjo]?![[[[]!!??I*{{rlllcc?uzo7zjjuunT#Jwfy25Fmd
                                *JywJ##TTuua]1t7LLjLLLjz7ot[Ir]att11[[aaeeeeoooeozjzet[>
                             1T2p6p5Fmh4Jeut1eoeLT#nL1ou##jeLne]!]!1j[[][[[[[]]I}I][1tee?
                         =[nypmqgdXbbYgzaTuTfzI}}}I!t}jTwjjJL}llllc}Tz?I*}}*****ssr*}}I[1[l
                     rcsoCF6pmgddVhgg6aaCL1##1IIIIII}!ettTwt%%v%cr?]{eI{v%cccllrrrsr*I??aw!}
              Q@GEVgqTnw2yw##TTuuLjj7oaat[]!?IIIIII??!!!7nt{>="i%c{![oea[[taeeeeeeet1eeeetta]i
        a7uJCJ#nLjz7ot1]!?II}**{{srlllrs*}}}}}I?]1e7juLLLLzL1%}1[11teat!rI?I*{srlccvccls{{srri:
    ufzx%lrcv)<\)||"""""|||)\\<<>)%l{**{rs}[7u#TuLz77zjuTL7]I{lx%vi><<\)ii\\\\\\\\\<>>%rss*{cv"
  Ypje{cx%%%%%%v%xxxcccllrs{*?[ezLuTJwf36dGdFw6Vg#Ii\\)xlxi|///////////////////////++++;_'^\v)"
  Y&&F7t!I!?!?t1jt[[1ttttaju5hggV&DkgpdBDXSo}?ttr";:_..-^"|/==^^^^^^^^^;^;;;;;;;;;;;;^">i|__/\/
 #L#e]1*%v%ii\v<\>>ii%v%xclI1e1ajhZFuo#hS#[II*v/)l***c\,`:^^;;;;;;;;;;;;;^^^^==++/=,;/%s][c:;=^
33]||vrr***{*{{rxllrrrrrsrlrllrs{{{{***}I?}r%<"%r1}]ts]{\_;;;===++////""""""||||||/;^){s![!\"}r
]z}i:,:\EGPE6q6VE44d};^==^^=+/"|\ir*?!1tsc)|/=c1?*I]![[?{\,+""/////""|)\<>)vxcrs{***>)!?*}[%{oe
=/"\=^'^t77joo7nJwfyc_'::^+""|)\>%}????#a=""+/!I!*r1nIs!tv|<vxlr{*}I??!???}*{rlxv)<|^|]u{}7%?
>wt)=+^_-` `. .   . ._``://"/""|)\)ls{}!d{;\i%]!aos{e[*e7vl**{srlc%%vii))>><<\\/^;^^=/%1!oI"
 Ewz[><<<<<>)%{{srcv)v))vlrsrrrlll*e7zz7ei)I]{Ia71e{}IjT?)^;,:'_-`.              -^+///>xi/
   .g `:;==/\l[1[I%<)""""+///"||)|+====+="||/"v?l*e]]nf?|`                         `_:,'-
        `_''''':'_.                       -;+|\<vs*?Ic<^
                                            `:^^^=+=^:but it makes more sense to save the image to a file:weconnect-clisave/vehicles/WVWABCE13SD057505/pictures/carcar.png
ls-alhcar.png
-rw-r--r--1tillsteinbachstaff135K5Jul15:07car.pngIf there is information regarding door, light and window status provided for your car you can also use the 'status' pictureDisabling featuresYou can disable data for the cars capabilities with--no-capabilitiesIf you only need a subset of the data you can use the--selectiveoption. E.g.--selective climatisationTested withVolkswagen ID.3 Modelyear 2021Volkswagen Passat GTE Modelyear 2021Reporting IssuesPlease feel free to open an issue atGitHub Issue pageto report problems you found.Known IssuesThe Tool is in alpha state and may change unexpectedly at any time!Related Projects:WeConnect-MQTT: MQTT Client that publishes data from Volkswagen WeConnectWeConnect-python: Python API to connect to Volkswagen WeConnect ServicesVWsFriend: VWsFriend is a software to visualize and record statistics of your car and allows control via HomeKitSeat, Cupra, Skoda IV, ...In an effort to try to make WeConnect-cli also to work with latest generation of vehicles from other volkswagen brands I'm looking for users to temporarily share access to their accounts. If you are willing to support please send me a message.Already tried: Cupra Born (The API looks a bit different, maybe it is older, I will check again in some weeks), thanks to the user initdebugs