Read and Combine Multiple Data Files

Combine multiple data files from a common directory. The data files will be read into R and bound together, creating a single large data.frame. A general function is provided along with a specific function for data that was collected using the open-source experiment builder 'OpenSesame' <>.


cran version DOI

readbulk is an R package that facilitates loading multiple data files with a similar structure and combining them into a single data.frame, using the read_bulk function. It wraps most common R functions for reading data, retaining the flexiblity of the available tools.

For (experimental) psychologists, the package provides the read_opensesame function which wraps the above, providing the appropriate defaults for loading the many files created by OpenSesame.

General Information

The readbulk package was developed by Pascal Kieslich, with contributions by Felix Henninger. It is published under the GNU General Public License (version 3).

An overview of the functions in this package can be found online. Please see news for a summary of changes in the package.


The current stable version is available on CRAN and can be installed via install.packages("readbulk").


If you would like to cite the readbulk package in your published research, you can cite is as follows:

Kieslich, P. J., & Henninger, F. (2016). Readbulk: An R package for reading and combining multiple data files.


readbulk 1.1.2

  • Improved speed of read_bulk and read_opensesame by binding data together only once (for every subdirectory)

readbulk 1.1.1

  • Online documentation added using the pkgdown package - it can be found at
  • As this release does not include any changes in the code or the function documentation, no new version was released on CRAN

readbulk 1.1.0

  • Introduced verbose argument so users can decide whether read_bulk and read_opensesame report its progress or not

readbulk 1.0.0

  • First release

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


1.1.3 by Pascal J. Kieslich, 2 months ago

Report a bug at

Browse source code at

Authors: Pascal J. Kieslich [aut, cre] , Felix Henninger [aut]

Documentation:   PDF Manual  

GPL-3 license

Imports utils, plyr, jsonlite

Suggested by mousetrap.

See at CRAN