Skip to content

File I/O

  • fd_midiread fd_midiread is a wrapper for mrpeach/midifile that loads and plays a MIDI file, though the help patch notes it is still a work in progress.
  • sndfwrites~ sndfwrites~ is a stereo sound-file writer that takes stereo signals through its first two inlets.
  • readdir readdir is a simple directory accessor that opens a directory and outputs its entries from the first outlet, including a type such as file, dir, fifo, or unknown.
  • path.lsdir path.lsdir lists the contents of a directory, outputting them as a list of strings.
  • dnd_dropfile dnd_dropfile provides a GUI target onto which a file or folder can be dragged and dropped, making its full path available through the specified send/receive name.
  • rec-name rec-name automatically creates a DATE_TIME.wav filename for a recording/playback engine.
  • oggwrite~ oggwrite~ writes a one- or two-channel Ogg Vorbis audio stream to a file, with VBR or bitrate settings and optional metadata comments.
  • +pager +pager provides “previous” and “next” controls for navigating files in a folder.
  • getdir getdir outputs the filesystem directory in which the current patch is operating as a symbol when it receives a bang.
  • path.pattern path.pattern generates a new filename from a symbol pattern, expanding ### sequences to numbers and variables such as %DATE%, %TIME%, or %NOW% to the current date and time.
  • fwriteln The fwriteln object writes text files line by line, serving as a simplified version of textfile.
  • pp.out-4~ pp.out-4~ provides four-channel speaker output and recording to a WAV sound file.
  • msgfile The msgfile object reads and writes messages to text files, extending the functionality of textfile.
  • stripdir stripdir removes all leading directories from a path, leaving its final component.
  • path.is_dir path.is_dir checks whether a path supplied as a symbol or data string exists and is a directory.
  • pofjson pofjson provides read-only JSON file utilities, loading JSON data and retrieving element sizes, strings with gets, or numbers with getf.
  • sampbuf~ sampbuf~ is a simple wrapper for soundfiler, intended to load or manage sample-buffer data.
  • pdp_qt pdp_qt plays a QuickTime movie, with messages for opening and closing files, controlling automatic playback and looping, and dumping contained audio to an array.
  • modplug~ modplug~ is a stereo MOD file player that uses libmodplug, with methods to load, play, pause, and stop a module file.
  • passwd passwd fetches filesystem password-database information for a user specified by UID or symbolic username, outputting fields such as username, UID, GID, home folder, and shell.
  • ___mtx_preset__ _mtx_preset is the same as mtx_preset but adds read and write functionality.
  • get-files get-files finds files in a selected folder that match a criterion such as /*.pd; its folder argument specifies where to look.
  • pofutil pofutil provides assorted path, directory, file, string, time, download, and archive utilities for Pd/OpenFrameworks patches.
  • matrix.load matrix.load loads a matrix from a CSV-format file and outputs the loaded Matrix.
  • pool pool is a hierarchical storage object that organizes key-associated values in directories and supports retrieval, counting, clearing, file persistence, and internal clipboard operations.
  • fd_pixrecord fd_pixrecord simplifies handling Gem’s pix_record for recording the current gemwin pixels to a movie file, with controls for starting and stopping, recording length, filename/path, and frame dimensions.
  • tdh.util.recorder.ui~ tdh.util.recorder.ui~ is a UI module for recording audio generated in Pd while passing the incoming signal through.
  • pix_buffer_filmopen The pix_buffer_filmopen object reads a movie file into a named pix_buffer for subsequent image processing within GEM.
  • pofxmlp pofxmlp provides XML file utilities based on pugixml, supporting loading, querying, editing, printing, and saving XML through a named reference.
  • pix_image The pix_image object loads image files (like TIFFs and JPEGs) into Pure Data, primarily for use as textures or for bitblitting operations within the GEM environment.
  • mtx_sfwrite mtx_sfwrite writes the rows of an input matrix to a multichannel sound file.
  • tdh.util.audioFileSm.ui~ tdh.util.audioFileSm.ui~ is a flexible audio-file player with controls for loading, playing, stopping, looping, normalizing, and selecting playback start and end points in milliseconds.
  • path.monitor path.monitor monitors filesystem events in a specified directory, such as file creation, updates, and moves.
  • midifile midifile reads and writes MIDI files, supporting playback, recording, track selection, and MIDI/meta-event output.
  • snd.file.resample The provided help-patch evidence is insufficient to determine what snd.file.resample does or how it is used.
  • fd_read-resize fd_read-resize reads a text file into an array, resizing the array first.
  • rec_play rec_play records and plays back a stream of floats, with support for writing to and loading from a wave file.
  • wavinfo wavinfo reads a selected .wav file and outputs information about it.
  • pix_film The pix_film object loads and plays digital video files, providing frames as textures for use within Pure Data's GEM environment.
  • msgsave msgsave works with saver to save parameters.
  • oggread~ oggread~ is an Ogg Vorbis file player that outputs audio signals and reports the current position in seconds, with a bang at the end of the file.
  • ffplay~ ffplay~ implements FFmpeg-based audio playback for various media formats, including URLs and M3U playlists, with playback-speed control.
  • pipewrite~ pipewrite~ is used with piperead~ to write audio through a pipe, as demonstrated with an opened WAV path.
  • file_type file_type finds the file type of a file specified by a symbol path.
  • fd_write2 fd_write2 is a stereo file recorder for writing audio to a file.
  • absolutepath absolutepath converts a filename supplied as a symbol for use relative to the patch’s path, outputting the resulting filename as a symbol.
  • datei-r datei-r produces a file-reading message, described by the patch as sending read ../../.
  • pix_buffer pix_buffer is a named storage object for images, functioning similarly to a table but without direct visual access to its contents.
  • path.exists path.exists checks whether a given path exists, accepting the path as either a symbol or string.
  • sfwrite~ sfwrite~ 2 is used to write a two-channel signal to a sound file, as illustrated by opening test.wav and supplying audio from adc~.
  • pix_movie The pix_movie object loads and plays digital video files, making their frames available as textures for real-time graphics rendering within GEM.
  • mp3fileout~ mp3fileout~ reads an MP3 file so its audio can be sent through mp3streamout~ for peer-to-peer streaming.
  • pp.out~ pp.out~ provides stereo speaker output and records the audio to a WAV sound file.
  • pofxml pofxml provides XML file utilities for loading, querying, modifying, and saving XML data, including selecting elements and attributes.
  • pdp_rawout pdp_rawout writes raw PDP data to a pipe or file, with an optional pipe path supplied as a creation argument.
  • path.file path.file provides file input/output operations around a symbol-valued file path, including opening, closing, reading, writing, seeking, removing, and renaming files.
  • audio-recorder audio-recorder records a stereo input as a 24-bit WAV file in the recorded_wavs folder within the project’s main folder, with an adjustable overall input gain.
  • poffilm poffilm is a video player that loads a movie file and displays it at an optional width and height.
  • obj_exporter obj_exporter provides a way to create an OBJ file from Gem primitives, with save test1.obj specifying the output file.
  • pdp_qt~ pdp_qt~ is a variant of pdp_qt that also outputs audio, as indicated by its connection to dac~.
  • folderpanel tof/folderpanel opens a folder-selection panel when it receives a bang.
  • satk.util.audioFileSm~ satk.util.audioFileSm~ is a flexible audio-file player that can also load raw data files for data mangling or sonification.
  • datei-o datei-o opens a file-selection dialog and outputs a message for opening the selected file, described by the help patch as open ../../.
  • relativepath relativepath converts a filename for use relative to the current patch’s path, supporting patch-relative file references.
  • pulqui pulqui reads a WAV file and generates a companion data file for use by pulqui-limiter.pd.
  • satk.util.recorder~ satk.util.recorder~ records audio generated in Pd to a WAV file while passing the incoming audio through.
  • anysoundfiler anysoundfiler accepts a soundfiler-style read -resize message to load a file into two channel arrays.
  • piperead~ piperead~ reads audio from an opened file and provides signals for playback through dac~.
  • lpaths lpaths demonstrates the distinction between self._canvaspath, the directory of the canvas where the object was created, and self._loadpath, the directory from which its .pd_lua file was loaded.
  • midi.file midi.file reads and writes Standard MIDI Files (SMF), storing their contents and outputting them as a MidiFile data type on bang.
  • pix_write The pix_write object captures a snapshot of the current GEM frame buffer and saves it to a file.
  • text3d The text3d object in Pure Data renders a single line of text within a 3D graphical environment, leveraging GEM's transformations.
  • soundfile_info soundfile_info reads and reports header data from a WAV sound file, including its sample rate, filename, sample length, header size, channel count, sample resolution, endianness, and format code.
  • ceammc.snd ceammc.snd is the ceammc library section for enhanced sound-file loading and playback.
  • glsl_geometry The glsl_geometry object loads and compiles a GLSL geometry shader from a specified file.
  • saveroute saveroute allows a Pd patch to use both messages and text files for saving state.
  • satk.util.audioFile~ satk.util.audioFile~ is a flexible audio-file player that loads files into an array, supports looping, normalization, selectable start and end points, and variable-speed playback; it can also load raw data files for data bending or sonification.
  • pp.out-8~ pp.out-8~ provides eight-channel speaker output and records the eight signal channels to a WAV sound file.
  • tdh.util.audioInUtility.ui~ tdh.util.audioInUtility.ui~ is a utility module that provides two-channel audio input from the ADC or a straightforward audio-file player, with channel muting, input gain, post-fader metering, and DSP controls.
  • fd_navigator fd_navigator is a file navigator for .pd files, intended for browsing a library of Pure Data patches.
  • basedir basedir performs basename and dirname operations on a filesystem path supplied as a symbol.
  • multimodel The multimodel object loads and renders multiple 3D Alias/Wavefront (.obj) models.
  • sample tof/sample loads a WAV sound file into a named sample’s tables for use by related playback, recording, and processing objects.
  • fd_write fd_write is a utility for writing a sound file when Pure Data is run from the terminal.
  • multiarray multiarray stores, displays, and operates on multiple graphical arrays, supporting value and size access, calculations, display settings, persistence, and mono audio-file I/O.
  • multitrack-recorder multitrack-recorder records up to eight input channels as 24-bit WAV files in ../recorder_wavs/multitrack/, with per-channel enable toggles and a global level control.
  • playlist playlist displays a file list for one-click file selection, optionally filtered by an extension such as mp3 or set to all.
  • dnd-openpanel dnd-openpanel is a deluxe file-opening object that accepts a dropped file or can be clicked to open a file-selection panel.
  • midi-player midi-player is a MIDI file player and analyzer based on mrpeach/midifile; it filters out non-note information and outputs notes in Pd style, along with file timing information, flushed note data, and an end-of-file bang.
  • outputc~ outputc~ is like output~, but it also accepts gain values through its right inlet and can record.
  • local.dict local.dict defines a dictionary variable in local scope, accessed by a symbolic ID so that local.dict objects with the same ID can refer to it.
  • openpanel openpanel queries the user for a filename by opening an “Open file” browser when it receives a bang.
  • fd_write5 fd_write5 is a five-track file recorder for writing audio to a file.
  • stat stat gets information about files, including metadata such as size, ownership, allocation, links, and access/modification/status-change timestamps, without changing the file.
  • fd_write1 fd_write1 is a mono file recorder with controls to start and stop recording and to reset all counters to zero.
  • freadln The freadln object reads text files line by line, outputting each line as a list.
  • glsl_vertex The glsl_vertex object loads and compiles a GLSL vertex shader into a module.
  • pofimage pofimage draws an image loaded from a file and can also expose it as a texture without drawing when the file argument is followed by TEX.
  • pp.sfplayer~ pp.sfplayer~ provides clean variable-speed playback of extra-long sound files, with stereo recording into its buffer and WAV export.
  • snd.file.position snd.file.position supports specifying positions for partial file loading with snd.file, including samples, seconds, milliseconds, and timecode formats.
  • ltextfile-drip ltextfile-drip reads a text file and outputs its sentences sequentially in response to incoming bangs, signaling with a bang when no lines remain.
  • iem_pbank_csv iem_pbank_csv is a parameter bank that stores parameter sets in numbered memory lines and reads or writes them using CSV-like syntax.
  • is_file is_file checks whether a file exists, is accessible, and can be opened, outputting 1 when it can and 0 otherwise.
  • DEAPlayer~ DEAPlayer~ is a .wav file player that supports variable playback speed and direction.
  • plist plist saves and recalls user-defined presets, outputting a selected preset as a series of parameter lists for use with objects such as preset.r and preset.s.
  • pix_film+ tof/pix_film+ is a more user-friendly Gem movie-file player that passes a gemlist through its first inlet and outlet.
  • sf-play_record The sf-play_record object provides a hard disk recording and playback system for Pure Data, enabling multi-track audio recordings.
  • ofDragged ofDragged listens for files dragged into the graphics window, outputting a list of their filenames and a separate list containing the x/y drag position.
  • fd_untext fd_untext reads a text file in a chaotic way.
  • file.size file.size reports the size of a file in bytes when given its path as a symbol or data string.
  • fd_printer fd_printer records messages sent to it in an internal text file, appending waits so GUI or patch-control interactions can later be recreated as a score.
  • path.dirname path.dirname outputs the directory portion of a pathname.
  • makerpath makerpath converts a pathname relative to the root canvas into an absolute path, while leaving already absolute paths unchanged.
  • ui.preset ui.preset manages saved values for UI objects on the canvas that have an @presetname, allowing their settings to be stored, loaded, cleared, interpolated, and read from or written to a file.
  • mp3write~ mp3write~ writes an incoming audio signal to an MP3 file, with configurable sample rate, bitrate, channel mode, and quality.
  • binfile binfile reads binary files into a buffer and writes the entire buffer back to a file; it can also store heterogeneous byte-float lists.
  • save_system save_system appears to demonstrate saving and loading data through load_save, with example entries named saved data1 and saved data2.
  • modelfiler The modelfiler object loads 3D model data from Alias/Wavefront OBJ files into Pure Data tables.
  • model The model object in Pure Data renders 3D models saved in the Alias/Wavefront OBJ format.
  • path.basename path.basename outputs the filename portion of a pathname.
  • adctowritesf64~ adctowritesf64~ records between 1 and 64 ADC channels to a sound file, with controls for the file name, bytes per sample, and starting or stopping the recording session.
  • readsftodac64~ readsftodac64~ plays a sound file through dynamically created connections for 1 to 64 output channels.
  • 0autopreset The help patch does not provide enough evidence to describe a distinct 0autopreset object; it appears to be an overview of the AutoPreset abstractions.
  • matrix.save matrix.save saves matrix data to a file in CSV format and outputs the original matrix.
  • readsfv~ readsfv~ reads a large sound file in direct-to-disk mode and outputs audio through two signal outlets.
  • txtsave txtsave works with a globally named savetxt store, supporting clear, write saveit.txt, and read saveit.txt messages for managing and persisting text data.
  • ceammc.path The patch does not document a ceammc.path object; it serves as an index of ceammc filesystem and path utilities.
  • dnd_parent dnd_parent detects a file or folder dropped onto its parent patcher window and outputs the full name and drop position.
  • notes notes fits Pure Data note data into music notation and encodes it as LilyPond scores, which it can compile.
  • mtx_sfread mtx_sfread reads rows from a multichannel sound file and outputs them as a matrix.
  • mpv mpv plays media into a GEM framebuffer, inheriting from gemframebuffer; its two leftmost outlets match gemframebuffer, while its third outlet reports media properties.
  • filemtime filemtime sets the last-modified time of files selected by a directory and filename or wildcard pattern, including matching files in all subdirectories.
  • snd.file snd.file loads sound files into Pd arrays, reports file information, and can save arrays in several audio or text formats.
  • getFolder getFolder takes an input file path as a symbol.
  • mtx_sndfileread mtx_sndfileread reads multichannel data from a sound file into a matrix.
  • strippath strippath removes the directory portion from a path symbol, leaving the file name.
  • path.normalize path.normalize lexically normalizes a file path without checking the filesystem.
  • fd_gemloop fd_gemloop stores an incoming Gem gemlist in a buffer for later playback or export of the stored images as JPEG files.
  • sndfread~ sndfread~ opens and reads a sound file, outputting stereo audio suitable for connection to dac~.
  • savepanel savepanel opens a “Save As” file browser when it receives a bang, allowing the user to choose a name for a file to create.
  • sfread2~ sfread2~ reads a sound file at a variable speed, including negative speeds, and outputs an audio signal.
  • tdh.util.recorder~ tdh.util.recorder~ records audio generated in Pd to a WAV file while passing the incoming audio through.
  • apmaster apmaster Ref saves and loads all presets belonging to Ref and its children to or from a single text file.
  • datei-w datei-w outputs a file-writing message, described by the help patch as write ../../.
  • pix_record The pix_record object in Pure Data is used to record sequences of video frames (pixes) to an output file, pipe, or video device.
  • msg_pbank msg_pbank provides scene-based storage for message data, with the creation argument apparently setting the bank size (for example, msg_pbank 20).
  • path.split path.split splits a filename or file path into its directory name and base name.
  • sndfwritem~ sndfwritem~ is a mono sound-file writer that records an incoming mono signal to a specified filename.
  • path path outputs and transforms filesystem paths, converting relative paths to absolute paths or absolute paths to relative paths.
  • getFile getFile takes an input file path as a symbol, but the help patch does not state what it outputs or its broader purpose.
  • pix_multiimage The pix_multiimage object loads multiple image files (TIFF, JPEG, PNG) into memory, which can then be used as textures or for bitblitting within GEM.
  • snd.file.pattern snd.file.pattern supports loading a sound file’s input channels into arrays whose names are expanded from a single pattern, such as sfp[1-4] becoming sfp1 through sfp4.
  • asdf~ asdf~ plays Audio Scene Description Format (ASDF) files and outputs their source signals, with its argument setting the number of signal outlets.
  • folder_list folder_list outputs a listing of files that match a wildcard pattern, defaulting to the directory from which Pd was launched when no argument is supplied.
  • pix_fiducialtrack The pix_fiducialtrack object detects and tracks fiducial markers in black and white grayscale images, utilizing a system similar to reacTable.
  • synth.fgrain~ synth.fgrain~ is an STK-based file granulator that opens a monophonic WAV or AIFF sound file and plays it as simultaneous grain voices.
  • pdp_rawin pdp_rawin reads raw data from a pipe or file and interprets it as a specified PDP type.
  • pix_imageInPlace The pix_imageInPlace object efficiently loads multiple image files (TIFF, JPEG, PNG) into texture RAM, enabling very fast switching between them.
  • sampbufs~ sampbufs~ is a simple stereo wrapper for soundfiler.
  • path.search path.search searches for a named file in user-defined paths and Pure Data directories, outputting the full path of the first match or a bang if none is found.
  • dnd-target dnd-target is a drag-and-drop receiver that lets a Pd GUI object act as a drop target for files.
  • play-audio-file~ play-audio-file~ is an abstraction that makes it easier to load and play a sound file from RAM.
  • tdh.util.audioFile.ui~ tdh.util.audioFile.ui~ is a flexible audio-file player with controls for loading, playing, stopping, looping, normalizing, and selecting playback start and end points in milliseconds; it can also load raw data files for data bending or sonification.
  • pix_writer The pix_writer object saves the current GEM texture (image) to a file on disk.
  • preset.storage preset.storage controls shared preset storage for preset-aware objects such as preset.float, preset.symbol, and preset.list, supporting storing, loading, clearing, duplicating, updating, and interpolating presets, as well as file read/write operations.