Skip to content
The Chargy E-Mobility Transparency Application for Windows, Mac OS X and Linux (based on Electron)
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
documentation
src
.compilerc
.eslintrc
.gitignore
CODE_OF_CONDUCT.md
GDF-ChargingSession01.json
LICENSE
README.md
chargeIT-ChargingSession03.json
chargy_Ladebildschirm_V4.gif
linux-live-image.md
package-lock.json
package.json
run.sh

README.md

Chargy Desktop App

Chargy is a transparency software for secure and transparent e-mobility charging processes, as defined by the German "Eichrecht". The software allows you to verify the cryptographic signatures of energy measurements within charge detail records and comes with a couple of useful extentions to simplify the entire process for endusers and operators.

Benefits of Chargy

  1. Chargy comes with meta data. True charging transparency is more than just signed smart meter values. Chargy allows you to group multiple signed smart meter values to entire charging sessions and to add additional meta data like EVSE information, geo coordinates, tariffs, ... within your backend in order to improve the user experience for the ev drivers.
  2. Chargy is secure. Chargy implements a public key infrastructure for managing certificates of smart meters, EVSEs, charging stations, charging station operators and e-mobility providers. By this the ev driver will always retrieve the correct public key to verify a charging process automatically and without complicated manual lookups in external databases.
  3. Chargy is platform agnostic. The entire software is available for desktop and smart phone operating systems and .NET. If you want ports to other platforms or programming languages, we will support your efforts.
  4. Chargy is Open Source. In contrast to other vendors in e-mobility, we belief that true transparency is only trustworthy if the entire process and the required software is open and reusable under a fair copyleft license (AGPL).
  5. Chargy is open for your contributions. We currently support adapters for the protocols of different charging station vendors like chargeIT mobility, ABL (OCMF), chargepoint. The certification at the Physikalisch-Technische Bundesanstalt (PTB) is provided by chargeIT mobility. If you want to add your protocol or a protocol adapter feel free to read the contributor license agreement and to send us a pull request.
  6. Chargy is white label. If you are a supporter of the Chargy project you can even use the entire software project under the free Apache 2.0 license. This allows you to create proprietary forks implementing your own corporate design or to include Chargy as a library within your existing application (This limitation was introduced to avoid discussions with too many black sheeps in the e-mobility market. We are sorry...).
  7. Chargy is accessible. For public sector bodies Chargy fully supports the EU directive 2016/2102 on the accessibility of websites and mobile applications and provides a context-sensitive feedback-mechanism and methods for dispute resolution.

Compiling from source

This application is based on Electron, a cross platform Open Source framework for creating native applications with web technologies like Java-/TypeScript, HTML, and (S)CSS.

Chargy is developed for and tested on the following operating systems:

  • Microsoft Windows 10+
  • Apple Mac OS X
  • Linux Debian/Ubuntu

The Chargy Desktop project has a sister project called Chargy Mobile which provides the same features, but is based on Apache Cordova and is available for the following operating systems:

  • Apple iOS
  • Google Android

System Requirements

Install nodejs on your system. For more details please check https://nodejs.org
On Linux and Mac OS X:

sudo curl -sL https://deb.nodesource.com/setup_11.x | sudo -E bash -
sudo apt install nodejs

$ sudo npm install -g electron-forge@latest
+ electron-forge@5.2.4

$ sudo npm install -g typescript@latest
+ typescript@3.3.3333

$ sudo npm install -g sass@latest
+ sass@1.17.2

Get the latest version

Clone the github repository for the latest version of chargy and install its nodejs dependencies:

git clone https://github.com/OpenChargingCloud/ChargyDesktopApp.git
cd ChargyDesktopApp
npm install
chmod +x run.sh
./run.sh

Building a Windows Installer

The Windows version can only be build on a Windows machine and uses Squirrel as an installation and update framework.

electron-forge make

Building a Linux package

On a Debian GNU/Linux or Ubuntu machine you can run the following commands to create a Debian software package. More information about this process can be found at: https://github.com/electron-userland/electron-installer-debian

sudo apt install debootstrap
electron-forge make

Now you can use the normal package management tools of your Linux distribution to install the app:

cd out/make
sudo dpkg -i chargyapp_X.Y.Z_amd64.deb

Building a Linux Live ISO Image

For special users like the Physikalisch-Technische Bundesanstalt Chargy is also available as a Linux Live CD/DVD. The creation of the ISO image is described in the following document linux-live-image.

You can’t perform that action at this time.