❮ Back

BadOS Dynamic Shell Package Library (bpl)

Contains all packages avaliable to install for bdsh.

Package URIs

Packages are located at

https://raw.githubusercontent.com/badtechnologies/bpl/main/lib/<package name>

Creating packages

Packages should be contained in a folder with the name of the package.

In the package root, create a bpl.json file, with the following contents:

{
 "name": "example bdsh package",
 "version": "1.0.0",
 "author": "Me!",
 "bin": "example.py",
 "homepage": "https://example.com",
 "license": "MIT",
 "requires": [
  "packagename",
  "another-package"
 ]
}

You can access a JSON schema for the bpl.json file at https://raw.githubusercontent.com/badtechnologies/bpl/main/bpl.schema.json

Most of this is self-explanatory. The bin key should point to the script to download. "example.py" tells bpm to download example.py from your package root. The file name will be discarded by bpm, and will be renamed to the name of your package. It is best practice to name your binary the same as your package.

Only name, version, and author must be included to make a valid package.

Not including bin will not download any binaries for your package; useful for package groups.

Not including requires will not download any dependencies.

How to install packages?

Use the BPM (BadOS Package Manager) to install, remove, or otherwise manage packages.

Example: installing a package:

bpm install <package name>

For more information, run bpm help, or see the bpm docs.