|
|
@@ -1,208 +0,0 @@
|
|
|
-# Other single-file public-domain/open source libraries with minimal dependencies
|
|
|
-
|
|
|
-In addition to all of [my libraries](https://github.com/nothings/stb), there are other, similar libraries.
|
|
|
-
|
|
|
-The following is a list of small, easy-to-integrate, portable libraries
|
|
|
-which are usable from C and/or C++, and should be able to be compiled on both
|
|
|
-32-bit and 64-bit platforms.
|
|
|
-
|
|
|
-### Rules
|
|
|
-
|
|
|
-- Libraries must be usable from C or C++, ideally both
|
|
|
-- Libraries should be usable from more than one platform (ideally, all major desktops and/or all major mobile)
|
|
|
-- Libraries should compile and work on both 32-bit and 64-bit platforms
|
|
|
-- Libraries should use at most two files
|
|
|
-
|
|
|
-Exceptions will be allowed for good reasons.
|
|
|
-
|
|
|
-### New libraries and corrections
|
|
|
-
|
|
|
-See discussion after the list.
|
|
|
-
|
|
|
-### JSON Parsing
|
|
|
-
|
|
|
-There are a lot of JSON parsers listed here. For some analysis and performance
|
|
|
-results, check out https://github.com/miloyip/nativejson-benchmark
|
|
|
-
|
|
|
-### Library listing
|
|
|
-
|
|
|
-**Public domain single-file libraries usable from C and C++ are in bold.** Other
|
|
|
-libraries are either non-public domain, or two files, or not usable from both C and C++, or
|
|
|
-all three. Libraries of more than two files are mostly forbidden.
|
|
|
-
|
|
|
-For the API column, "C" means C only, "C++" means C++ only, and "C/C++" means C/C++ usable
|
|
|
-from either; some files may require *building* as C or C++ but still qualify as "C/C++" as
|
|
|
-long as the header file uses `extern "C"` to make it work. (In some cases, a header-file-only
|
|
|
-library may compile as both C or C++, but produce an implementation that can only be called from
|
|
|
-one or the other, because of a lack of use of `extern "C"`; in this case the table still qualifies it
|
|
|
-as C/C++, as this is not an obstacle to most users.)
|
|
|
-
|
|
|
-
|
|
|
-category | library | license | API |files| description
|
|
|
------------------ | --------------------------------------------------------------------- |:--------------------:|:---:|:---:| -----------
|
|
|
-AI | [micropather](http://www.grinninglizard.com/MicroPather/) | zlib | C++ | 2 | pathfinding with A\*
|
|
|
-AI | [Genann](https://github.com/codeplea/genann) | zlib |C/C++| 2 | simple neural networks (ANN)
|
|
|
-argv | [parg](https://github.com/jibsen/parg) | **public domain** | C | 1 | command-line argument parsing
|
|
|
-audio | [aw_ima.h](https://github.com/afterwise/aw-ima/blob/master/aw-ima.h) | MIT |C/C++|**1**| IMA-ADPCM audio decoder
|
|
|
-audio |**[dr_flac](https://github.com/mackron/dr_libs)** | **public domain** |C/C++|**1**| FLAC audio decoder
|
|
|
-audio |**[dr_wav](https://github.com/mackron/dr_libs)** | **public domain** |C/C++|**1**| WAV audio loader
|
|
|
-audio |**[sts_mixer](https://github.com/kieselsteini/sts)** | **public domain** |C/C++|**1**| simple stereo audio mixer
|
|
|
-compression |**[miniz.c](https://github.com/richgel999/miniz)** |**public domain**|C/C++|**1**| compression,decompression, zip file, png writing
|
|
|
-compression | [lz4](https://github.com/Cyan4973/lz4) | BSD |C/C++| 2 | fast but larger LZ compression
|
|
|
-compression | [fastlz](https://code.google.com/archive/p/fastlz/source/default/source) | MIT |C/C++| 2 | fast but larger LZ compression
|
|
|
-compression | [pithy](https://github.com/johnezang/pithy) | BSD |C/C++| 2 | fast but larger LZ compression
|
|
|
-crypto | [TweetNaCl](http://tweetnacl.cr.yp.to/software.html) | **public domain** | C | 2 | high-quality tiny cryptography library
|
|
|
-data structures|[klib](http://attractivechaos.github.io/klib/) | MIT |C/C++| 2 | many 2-file libs: hash, sort, b-tree, etc
|
|
|
-data structures | [uthash](https://github.com/troydhanson/uthash) | BSD |C/C++| 2 | several 1-header, 1-license-file libs: generic hash, list, etc
|
|
|
-data structures | [PackedArray](https://github.com/gpakosz/PackedArray) | **WTFPLv2** | C | 2 | memory-efficient array of elements with non-pow2 bitcount
|
|
|
-data structures | [minilibs](https://github.com/ccxvii/minilibs) | **public domain** | C | 2 | two-file binary tress (also regex, etc)
|
|
|
-data structures |**[DG_dynarr.h](https://github.com/DanielGibson/Snippets/)** | **public domain** |C/C++|**1**| typesafe dynamic arrays (like std::vector) for plain C
|
|
|
-files & filenames |**[DG_misc.h](https://github.com/DanielGibson/Snippets/)** | **public domain** |C/C++|**1**| Daniel Gibson's stb.h-esque cross-platform helpers: path/file, strings
|
|
|
-files & filenames | [whereami](https://github.com/gpakosz/whereami) | **WTFPLv2** |C/C++| 2 | get path/filename of executable or module
|
|
|
-files & filenames | [dirent](https://github.com/tronkko/dirent) | MIT |C/C++|**1**| dirent for windows: retrieve file & dir info
|
|
|
-files & filenames | [TinyDir](https://github.com/cxong/tinydir) | BSD | C |**1**| cross-platform directory reader
|
|
|
-geometry file | [tk_objfile](https://github.com/joeld42/tk_objfile) | MIT |C/C++|**1**| OBJ file loader
|
|
|
-geometry file | [tinyply](https://github.com/ddiakopoulos/tinyply) | **public domain** | C++ | 2 | PLY mesh file loader
|
|
|
-geometry file | [tinyobjloader](https://github.com/syoyo/tinyobjloader) | MIT | C++ |**1**| wavefront OBJ file loader
|
|
|
-geometry file | [tinyobjloader-c](https://github.com/syoyo/tinyobjloader-c) | MIT | C |**1**| wavefront OBJ file loader
|
|
|
-geometry file | [yocto_obj.h](https://github.com/xelatihy/yocto-gl) | MIT |C/C++|**1**| wavefront OBJ file loader
|
|
|
-geometry math |**[nv_voronoi.h](http://www.icculus.org/~mordred/nvlib/)** | **public domain** |C/C++|**1**| find voronoi regions on lattice w/ integer inputs
|
|
|
-geometry math |**[sobol.h](https://github.com/Marc-B-Reynolds/Stand-alone-junk/)** | **public domain** |C/C++|**1**| sobol & stratified sampling sequences
|
|
|
-geometry math | [sdf.h](https://github.com/memononen/SDF) | MIT |C/C++|**1**| compute signed-distance field from antialiased image
|
|
|
-geometry math | [nanoflann](https://github.com/jlblancoc/nanoflann) | BSD | C++ |**1**| build KD trees for point clouds
|
|
|
-geometry math | [jc_voronoi](https://github.com/JCash/voronoi) | MIT |C/C++|**1**| find voronoi regions on float/double data
|
|
|
-geometry math | [par_msquares](https://github.com/prideout/par) | MIT |C/C++|**1**| convert (binarized) image to triangles
|
|
|
-geometry math | [par_shapes](http://github.prideout.net/shapes) | MIT |C/C++|**1**| generate various 3d geometric shapes
|
|
|
-geometry math | [Tomas Akenine-Moller snippets](http://tinyurl.com/ht79ndj) | **public domain** |C/C++| 2 | various 3D intersection calculations, not lib-ified
|
|
|
-geometry math | [Clipper](http://www.angusj.com/delphi/clipper.php) | Boost | C++ | 2 | line & polygon clipping & offsetting
|
|
|
-geometry math | [PolyPartition](https://github.com/ivanfratric/polypartition) | MIT | C++ | 2 | polygon triangulation, partitioning
|
|
|
-geometry math | [Voxelizer](https://github.com/karimnaaji/voxelizer) | MIT |C/C++|**1**| convert triangle mesh to voxel triangle mesh
|
|
|
-geometry math | [yocto_bvh.h](https://github.com/xelatihy/yocto-gl) | MIT |C/C++|**1**| ray-casting and closest-element queries of bounding-volume hierarchy
|
|
|
-geometry math | [yocto_shape.h](https://github.com/xelatihy/yocto-gl) | MIT |C/C++|**1**| shape generation, tesselation, normals, etc.
|
|
|
-graphics (3d) | [yocto_trace.h](https://github.com/xelatihy/yocto-gl) | MIT |C/C++|**1**| physically-based unidirectional path tracer w/ MIS for direct lights
|
|
|
-graphics (3d) | [yocto_symrigid.h](https://github.com/xelatihy/yocto-gl) | MIT |C/C++|**1**| rigid body simulator (sequential impulse/PGS) with support for concave objects
|
|
|
-graphics (2d) | [blendish](https://bitbucket.org/duangle/oui-blendish/src) | MIT |C/C++|**1**| blender-style widget rendering
|
|
|
-graphics (2d) | [tigr](https://bitbucket.org/rmitton/tigr/src) | **public domain** |C/C++| 2 | quick-n-dirty window text/graphics for Windows and OSX
|
|
|
-graphics (2d) | [noc_turtle](https://github.com/guillaumechereau/noc) | MIT |C/C++| 2 | procedural graphics generator
|
|
|
-graphics (3-D) | [mikktspace](http://tinyurl.com/z6xtucm) | zlib |C/C++| 2 | compute tangent space for normal mapping
|
|
|
-graphics (3-D) | [debug-draw](https://github.com/glampert/debug-draw) | **public domain** | C++ |**1**| API-agnostic immediate-mode debug rendering
|
|
|
-graphics (3-D) |**[lightmapper](https://github.com/ands/lightmapper#lightmapper)** | **public domain** |C/C++|**1**| use your OpenGL renderer to offline bake lightmaps
|
|
|
-hardware |**[EasyTab](https://github.com/ApoorvaJ/EasyTab)** | **public domain** |C/C++|**1**| multi-platform tablet input
|
|
|
-images | [jo_gif.cpp](http://www.jonolick.com/home/gif-writer) | **public domain** | C++ |**1**| animated GIF writer (CPP file can also be used as H file)
|
|
|
-images |**[gif.h](https://github.com/ginsweater/gif-h)** | **public domain** | C |**1**| animated GIF writer (can only include once)
|
|
|
-images |**[tiny_jpeg.h](https://github.com/serge-rgb/TinyJPEG/)** | **public domain** |C/C++|**1**| JPEG encoder
|
|
|
-images |**[gif_load](https://github.com/hidefromkgb/gif_load)** | **public domain** |C/C++|**1**| (animated) GIF reader
|
|
|
-images | [miniexr](https://github.com/aras-p/miniexr) | **public domain** | C++ | 2 | OpenEXR writer, needs header file
|
|
|
-images | [tinyexr](https://github.com/syoyo/tinyexr) | BSD |C/C++|**1**| EXR image read/write, uses miniz internally
|
|
|
-images | [lodepng](http://lodev.org/lodepng/) | zlib |C/C++| 2 | PNG encoder/decoder
|
|
|
-images | [nanoSVG](https://github.com/memononen/nanosvg) | zlib |C/C++|**1**| 1-file SVG parser; 1-file SVG rasterizer
|
|
|
-images | [picopng.cpp](http://lodev.org/lodepng/picopng.cpp) | zlib | C++ | 2 | tiny PNG loader
|
|
|
-images | [jpeg-compressor](https://github.com/richgel999/jpeg-compressor) | **public domain** | C++ | 2 | 2-file jpeg compress, 2-file jpeg decompress
|
|
|
-images | [easyexif](https://github.com/mayanklahiri/easyexif) | MIT | C++ | 2 | EXIF metadata extractor for JPEG images
|
|
|
-images |**[cro_mipmap.h](https://github.com/thebeast33/cro_lib)** | **public domain** |C/C++|**1**| average, min, max mipmap generators
|
|
|
-math | [mm_vec.h](https://github.com/vurtun/mmx) | BSD |C/C++|**1**| SIMD vector math
|
|
|
-math |**[Handmade Math](https://github.com/StrangeZak/Handmade-Math)** | **public domain** |C/C++|**1**| vector math
|
|
|
-math |**[gb_math](https://github.com/gingerBill/gb/blob/master/gb_math.h)** | **public domain** |C/C++|**1**| Vector, quaternion and matrix math w/o math.h
|
|
|
-math |**[ccVector.h](https://github.com/jobtalle/ccVector)** | **public domain** |C/C++|**1**| Vector, quaternion and matrix math
|
|
|
-math | [ShaderFastLibs](https://github.com/michaldrobot/ShaderFastLibs) | MIT | C++ |**1**| (also HLSL) approximate transcendental functions optimized for shaders (esp. GCN)
|
|
|
-math | [TinyExpr](https://github.com/codeplea/tinyexpr) | zlib | C | 2 | evaluation of math expressions from strings
|
|
|
-math | [linalg.h](https://github.com/sgorsten/linalg) | **unlicense** | C++ |**1**| vector/matrix/quaternion math
|
|
|
-math | [PoissonGenerator.h](https://github.com/corporateshark/poisson-disk-generator) | MIT | C++ |**1**| Poisson disk points generator (disk or rect)
|
|
|
-math | [prns.h](http://marc-b-reynolds.github.io/shf/2016/04/19/prns.html) | **public domain** |C/C++|**1**| seekable pseudo-random number sequences
|
|
|
-math | [aomeba](https://github.com/starwing/amoeba) | MIT |C/C++|**1**| constraint solver (Cassowary) w/Lua binding
|
|
|
-multithreading | [mm_sched.h](https://github.com/vurtun/mmx) | zlib |C/C++|**1**| cross-platform multithreaded task scheduler
|
|
|
-network |**[zed_net](https://github.com/ZedZull/zed_net)** | **public domain** |C/C++|**1**| cross-platform socket wrapper
|
|
|
-network |**[sts_net](https://github.com/kieselsteini/sts)** | **public domain** |C/C++|**1**| cross-platform socket wrapper (socket sets and packet API)
|
|
|
-network | [mm_web.h](https://github.com/vurtun/mmx) | BSD |C/C++|**1**| lightweight webserver, fork of webby
|
|
|
-network | [par_easycurl.h](https://github.com/prideout/par) | MIT |C/C++|**1**| curl wrapper
|
|
|
-network | [yocto](https://github.com/tom-seddon/yhs) | **public domain** |C/C++| 2 | non-production-use http server
|
|
|
-network | [happyhttp](https://github.com/Zintinio/HappyHTTP) | zlib | C++ | 2 | http client requests
|
|
|
-network | [mongoose](https://github.com/cesanta/mongoose) |_GPLv2_ |C/C++| 2 | http server
|
|
|
-network | [LUrlParser](https://github.com/corporateshark/LUrlParser) | MIT | C++ | 2 | lightweight URL & URI parser RFC 1738, RFC 3986
|
|
|
-network | [znet](https://github.com/starwing/znet) | MIT |C/C++|**1**| cross-platform networking w/ lua binding
|
|
|
-parsing | [SLRE](https://github.com/cesanta/slre) |_GPLv2_ |C/C++|**1**| regular expression matcher
|
|
|
-parsing | [PicoJSON](https://github.com/kazuho/picojson) | BSD | C++ |**1**| JSON parse/serializer
|
|
|
-parsing | [mm_lexer.h](https://github.com/vurtun/mmx) | zlib |C/C++|**1**| C-esque language lexer
|
|
|
-parsing | [json.h](https://github.com/sheredom/json.h) | **public domain** |C/C++| 2 | JSON parser
|
|
|
-parsing | [jzon.h](https://github.com/Zguy/Jzon) | MIT | C++ | 2 | JSON parser
|
|
|
-parsing | [parson](https://github.com/kgabis/parson) | MIT |C/C++| 2 | JSON parser and serializer
|
|
|
-parsing | [minilibs](https://github.com/ccxvii/minilibs) | **public domain** | C | 2 | two-file regex (also binary tree, etc)
|
|
|
-profiling | [Remotery](https://github.com/Celtoys/Remotery) | Apache 2.0 |C/C++| 2 | CPU/GPU profiler Win/Mac/Linux, using web browser for viewer
|
|
|
-profiling | [MicroProfile](https://bitbucket.org/jonasmeyer/microprofile) | **unlicense** | C++ | 2-4 | CPU (and GPU?) profiler, 1-3 header files, uses miniz internally
|
|
|
-scripting | [LIL](http://runtimeterror.com/tech/lil/) | zlib |C/C++| 2 | interpreter for a Tcl-like scripting language
|
|
|
-scripting | [lualite](https://github.com/janezz55/lualite/) | MIT | C++ |**1**| generate lua bindings in C++
|
|
|
-scripting | [Picol](https://chiselapp.com/user/dbohdan/repository/picol/) | BSD |C/C++|**1**| interpreter for a Tcl-like scripting language
|
|
|
-strings |**[DG_misc.h](https://github.com/DanielGibson/Snippets/)** | **public domain** |C/C++|**1**| Daniel Gibson's stb.h-esque cross-platform helpers: path/file, strings
|
|
|
-strings |**[utf8](https://github.com/sheredom/utf8.h)** | **public domain** |C/C++|**1**| utf8 string library
|
|
|
-strings |**[strpool.h](https://github.com/mattiasgustavsson/libs)** | **public domain** |C/C++|**1**| string interning
|
|
|
-strings | [dfa](http://bjoern.hoehrmann.de/utf-8/decoder/dfa/) | MIT |C/C++| 2 | fast utf8 decoder (need a header file)
|
|
|
-strings |**[gb_string.h](https://github.com/gingerBill/gb)** | **public domain** |C/C++|**1**| dynamic strings
|
|
|
-tests | [utest](https://github.com/evolutional/utest) | MIT |C/C++|**1**| unit testing
|
|
|
-tests | [catch](https://github.com/philsquared/Catch) | Boost | C++ |**1**| unit testing
|
|
|
-tests | [doctest](https://github.com/onqtam/doctest) | MIT | C++ |**1**| unit testing
|
|
|
-tests | [SPUT](http://www.lingua-systems.com/unit-testing/) | BSD |C/C++|**1**| unit testing
|
|
|
-tests | [pempek_assert.cpp](https://github.com/gpakosz/Assert) | **WTFPLv2** | C++ | 2 | flexible assertions
|
|
|
-tests | [minctest](https://github.com/codeplea/minctest) | zlib | C |**1**| unit testing
|
|
|
-tests | [greatest](https://github.com/silentbicycle/greatest) | iSC | C |**1**| unit testing
|
|
|
-tests | [µnit](https://github.com/nemequ/munit) | MIT | C |**1**| unit testing
|
|
|
-user interface | [dear imgui](https://github.com/ocornut/imgui) | MIT | C++ | 9 | an immediate-mode GUI formerly named "ImGui"; [3rd-party C wrapper](https://github.com/Extrawurst/cimgui)
|
|
|
-user interface | [nuklear](https://github.com/vurtun/nuklear) | **public domain** |C/C++|**1**| minimal GUI toolkit
|
|
|
-user interface | [noc_file_dialog.h](https://github.com/guillaumechereau/noc) | MIT |C/C++| 1 | file open/save dialogs (Linux/OSX/Windows)
|
|
|
-user interface | [tinyfiledialogs](https://sourceforge.net/projects/tinyfiledialogs/) | ZLIB |C/C++| 2 | modal dialogs inc. file open/save (Linux/OSX/Windows)
|
|
|
-video | [jo_mpeg](http://www.jonolick.com/home/mpeg-video-writer) | **public domain** | C++ |**1**| mpeg file writer
|
|
|
-_misc_ | [MakeID.h](http://www.humus.name/3D/MakeID.h) | **public domain** | C++ |**1**| allocate/deallocate small integer IDs efficiently
|
|
|
-_misc_ | [loguru](https://github.com/emilk/loguru) | **public domain** | C++ |**1**| flexible logging
|
|
|
-_misc_ | [tinyformat](https://github.com/c42f/tinyformat) | Boost | C++ |**1**| typesafe printf
|
|
|
-_misc_ | [dbgtools](https://github.com/wc-duck/dbgtools) | zlib |C/C++| 2 | cross-platform debug util libraries
|
|
|
-_misc_ | [stmr](https://github.com/wooorm/stmr.c) | MIT | C | 2 | extract English word stems
|
|
|
-_misc_ | [levenshtein](https://github.com/wooorm/levenshtein.c) | MIT | C | 2 | compute edit distance between two strings
|
|
|
-
|
|
|
-There are also these XML libraries, but if you're using XML, shame on you:
|
|
|
-
|
|
|
-- parsing: [tinyxml2](https://github.com/leethomason/tinyxml2): XML
|
|
|
-- parsing: [pugixml](http://pugixml.org/): XML (MIT license)
|
|
|
-
|
|
|
-Also you might be interested in other related, but different lists:
|
|
|
-
|
|
|
-- [clib](https://github.com/clibs/clib/wiki/Packages): list of (mostly) small single C functions (licenses not listed)
|
|
|
-
|
|
|
-## New libraries and corrections
|
|
|
-
|
|
|
-Submissions of new libraries: I accept submissions (as issues or as pull requests). Please
|
|
|
-note that every file that must be included in a user's project counts; a header and a source
|
|
|
-file is 2 files, but a header file, source file, and LICENSE (if the license isn't in the
|
|
|
-source file) is 3 files, and won't be accepted, because it's not 2 files. But actually
|
|
|
-'LICENSE' is a problem for just dropping the library in a source tree anyway, since it's
|
|
|
-not scoped to just the library, so library authors are encouraged to include the license in the
|
|
|
-source file and not require a separate LICENSE.
|
|
|
-
|
|
|
-Corrections: if information for a library above is wrong, please send a correction as an
|
|
|
-issue, pull request, or email. Note that if the list indicates a library works from both
|
|
|
-C/C++, but it doesn't, this could be an error in the list or it could be a bug in the
|
|
|
-library. If you find a library doesn't work in 32-bit or 64-bit, the library should be
|
|
|
-removed from this list, unless it's a bug in the library.
|
|
|
-
|
|
|
-## *List FAQ*
|
|
|
-
|
|
|
-### Can I link directly to this list?
|
|
|
-
|
|
|
-Yes, you can just use this page. If you want a shorter, more readable link, you can use [this URL](https://github.com/nothings/stb#other_libs) to link to the FAQ question that links to this page.
|
|
|
-
|
|
|
-### Why isn't library XXX which is made of 3 or more files on this list?
|
|
|
-
|
|
|
-I draw the line arbitrarily at 2 files at most. (Note that some libraries that appear to
|
|
|
-be two files require a separate LICENSE file, which made me leave them out). Some of these
|
|
|
-libraries are still easy to drop into your project and build, so you might still be ok with them.
|
|
|
-But since people come to stb for single-file public domain libraries, I feel that starts
|
|
|
-to get too far from what we do here.
|
|
|
-
|
|
|
-### Why isn't library XXX which is at most two files and has minimal other dependencies on this list?
|
|
|
-
|
|
|
-Probably because I don't know about it, feel free to submit a pull request, issue, email, or tweet it at
|
|
|
-me (it can be your own library or somebody else's). But I might not include it for various
|
|
|
-other reasons, including subtleties of what is 'minimal other dependencies' and subtleties
|
|
|
-about what is 'lightweight'.
|
|
|
-
|
|
|
-### Why isn't SQLite's amalgamated build on this list?
|
|
|
-
|
|
|
-Come on.
|
Sean Barrett