A python script that converts between schematic file formats
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 407 commits ahead, 2 commits behind machinaut:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


The Upverter Universal Format Converter

A command line python anything-in anything-out file converter to go between the multitude of electrical circuit schematic file formats. This project was started by Alex Ray (ajray@ncsu.edu), on behalf of Upverter (http://upverter.com).

Folder Contents

  • core/ - All of the converter code
  • doc/ - Everything related to documentation
  • library/ - Library files for the software packages that dont export complete files
  • parser/ - All of the in code
  • test/ - A set of test files for each format
  • writer/ - All of the out code


usage: upconvert.py [-h] [-i INPUT] [-f TYPE] [-o OUTPUT] [-s SYMDIRS [SYMDIRS ...]] [-t TYPE]

optional arguments:
  -h, --help            show this help message and exit
  -i INPUT, --input INPUT
                        read INPUT file in
  -f TYPE, --from TYPE  read input file as TYPE
  -o OUTPUT, --output OUTPUT
                        write OUTPUT file out
  -s SYMDIRS [SYMDIRS ...], --sym-dirs SYMDIRS [SYMDIRS ...]
                        specify SYMDIRS to search for .sym files (for gEDA
  -t TYPE, --to TYPE    write output file as TYPE

Where to Get Help

./upconvert.py -h

Github: Submit an issue, or pull request. Email: support@upverter.com

Supported Formats

The converter can import and export in the following popular open and closed source formats.

  • KiCad
  • gEDA
  • Eagle (in testing)
  • Eagle XML (in testing)
  • Fritzing (in testing)

Format Wish List

This is the list of formats we wish we supported, and will work on or finish someday soon. We are looking for developers to help us so please ping us if you're interested!

  • Altium (in development)
  • Gerber (in development)
  • ViewDraw (in development)
  • DXDesigner
  • PADs
  • Alegro
  • OrCad
  • DSN


This is the list of formats we can export too, given an import with the required info in it. These are currently all in development.

  • BOM (Bill of Materials) in CSV format
  • Netlist in CSV format
  • Netlist in Telesis format
  • Layout Data in RS274-X (Gerber) format
  • Drill Data in Excellon format

The Concept

To use an Upverter Open JSON export in another piece of software, you will need to convert it into that software's proprietary format. Likewise, to get your data out of another piece of software and import it into Upverter, you will also need to run their export through the converter. We are working to make this easier, but we will largely depend on community contribution and the participation of the other vendors.

Interchange Format Documentation

The converter is based on the Upverter Open JSON Format fully documented at http://upverter.com/resources/open-json-format/. We hope that someday all of the major providers of schematic capture software will support interoperability with open formats like this one.