openFrameworks addon for reading and writing CSV(Character Separated Values) Files.
Switch branches/tags
Nothing to show
Clone or download


ofxCsv is an addon for openFrameworks to read and write CSV(Character Separated Values) files.

You can choose a character separator to create individual tables.

Inspired and based on Ben Fry's table class.

Check out for new release at

Current Version

0.2.0 (stable and versioned using semantic versioning)

Basic API Overview


load(string path, string separator, string comment)
load(string path, string separator)
load(string path)

load(vector<ofxCsvRow> rows)
load(vector<string> rows)

save(string path, bool quote, string separator)
save(string path, bool quote)
save(string path)

createFile(string path)

addRow(ofxCsvRow row)
setRow(int index, ofxCsvRow row)
getRow(int index)
insertRow(int index, ofxCsvRow row)
removeRow(int index)


load(string cols, string separator)
load(vector<string> cols)

getInt(int col)
getFloat(int col)
getString(int col)
getBool(int col)

addInt(int what)
addFloat(int what)
addString(int what)
addBool(int what)

setInt(int col, int what)
setFloat(int col, float what)
setString(int col, string what)
setBool(int col, bool what)

insertInt(int col, int what)
insertFloat(int col, float what)
insertString(int col, string what)
insertBool(int col, bool what)

remove(int col)

See src/ofxCsv.h & src/ofxCsv.h for detailed information & additional functionality.

Installation & Usage

To install ofxCsv, move the ofxCsv folder to your openFrameworks/addons folder.

Basic usage is demonstrated by csvExample.

With OF version 0.9.0+, the OF Project Generator will add the compiler search paths for the project automatically if configured to include ofxCsv.

Project files for the example are not included so you will need to generate the project files for your operating system and development environment using the OF ProjectGenerator which is included with the OpenFrameworks distribution.

Press the Import button in the ProjectGenerator & select the addons/ofxCsv/csvExample folder. Next, press the "Generate" to populate the example with the project files you will need to build it on your OS.

Issues and Bugs

You can find a list of all known bugs at GitHub. Please report if you find an unknown bug.


A detailed changelog, intended for programmers.

partial rewrite & update to OF 0.9+, added ofxCsvRow

small bugfix (thanks to Pinkerton)

moved to ofxCsv Repository

small changes (also at ofxWrongPowder Repository)

starting addon at ofxWrongPowder Repository



ofxCsv is Licensed under MIT Public License:

See also, LICENSE.txt in this distribution.