GLAM

Godot Libre Asset Manager

Godot plugin for finding, downloading and managing free, libre, and creative commons assets. Work in progress.

Goals

1. Quick prototyping.

It can be quite tedious to download assets, unzip them, copy their files over to your Godot project and then setup resources to use the files. GLAM aims to make it easy to download and setup assets with a single click and then drag them directly into the scene or inspector. This can be useful if you want to quickly try out many different assets, or want to work quickly, such as in a game jam.

2. Keep track of licenses and attribution.

Many free asset licenses require attribution as part of their requirements and keeping track of license and attribution information can also be quite tedious. GLAM aims to make this easy by following the reuse specification and creating .license files along side downloaded assets that also include additional metadata such as author profile urls, original titles, and download sources. These files can then be used to automatically generate credits that can be added to the documentation or shown in-game.

Sources

GLAM offers (or plans to offer) integration with the APIs of the following sources. Some of these sources require an api account to use (see 'Account Required').

Source	Account Required	Support	Notes
AmbientCG	No	Partial	Currently only PBR textures. No search filters
Pixabay	Yes	Partial	Currently only images (no videos). No search filters
Freesound	Yes	In progress	Sound Effects
Openclipart	Yes	Planned	Vector Graphics
FreeSVG	Yes	Planned	Vector Graphics
Noun Project	Yes	Planned	Icons, Images
Poly Haven	No	Planned	PBR Textures, 3D Models, HDRs
Sketchfab	Yes	Planned	3D Models
Jamendo	Yes	Planned	Music
ccMixter	No	Planned	Music
SoundCloud	Yes	Planned	Music

Installation

Copy the addons/glam directory in this repo to your Godot project.

Or install the gd-plug plugin. By adding the following to your plug.gd file (changing the commit hash to the version of GLAM you want to use):

plug("lihop/glam", {commit = "432cb3561db0b2e69471883b13e24e0f5d15e155", include = ["addons/glam"]})

Screenshots

Developing

If you cloned this repo locally and want to work on it you will need to install the plugins using the following command to install additional plugins:

godot --no-window -s plug.gd install

Testing

GLAM uses the Gut tool for testing. These tests can be run from the command line using:

godot --no-window -s addons/gut/gut_cmdln.gd

By default, only unit tests will be run. To run all tests (including integration tests) use:

godot --no-window -s addons/gut/gut_cmdln.gd -gconfig=.gutconfig_all.json

Note: Integration tests require Node.js to be installed as they use the npx command to start an http-server HTTP server. The integration tests also take a long time (more than 30 seconds) to run.