BadOS Dynamic Shell (bdsh)

Read the docs at badtechnologies.github.io/bdsh.

Quick Install

Run the following command:

python3 -m pip install bdsh
python3 -m bdsh.install

The installer creates the shell root, config directory, and first user.

Installation (Manual)

Download the latest release.

Or, install the package from PyPI.
Set up bdsh:
```
python3 -m bdsh.install
```
Follow the prompts. The setup script creates the bdsh/ directory tree and config files.
Start bdsh:
```
bdsh
```

Before logging in, start the BadLogon service in one terminal:

boss badlogon.sys

Then run bdsh in another terminal. The shell prompts for a username and password, then starts an interactive session.

Minimal boot profile

For a minimal boot prompt that does not start services or request a BadLogon login, run:

bdsh-init

The same entry point is available as python3 -m bdsh.init. It starts a minimal session as the default user in bdsh/prf/default, relative to the process's working directory. It does not start services or prompt for login.

Metadata

Release files for bdsh 0.7.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bdsh 0.7.2
File	Size	Uploaded
bdsh-0.7.2.tar.gz	33.7 kB	Oct 14, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for bdsh 0.7.2
File	Interpreter	ABI	Platform	Reset
bdsh-0.7.2-py3-none-any.whl 27.3 kB Oct 14, 2026	Python 3	none	any	Details

Total release size: 61.0 kB

Release files / bdsh-0.7.2.tar.gz

Download URL	bdsh-0.7.2.tar.gz
Size	33.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`c370eb682c5f1956a7e72c53470dd1112d9f870f3d4395d9f3dd573411d5ea4a`
BLAKE2b-256 checksum How to use checksums	`fd0f476aca6f3fa1ba288b01ae68ec702f1ea0378377cd6f34acf167e6cfff0f`
Upload date	Oct 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/badtechnologies/bdsh
Publishing commit: github.com/badtechnologies/bdsh/tree/d0654fd4026360d2e8c2d84b9f86de10fe076330

Workflow

Publishing configuration: github.com/badtechnologies/bdsh/blob/d0654fd4026360d2e8c2d84b9f86de10fe076330/.github/workflows/publish.yml
Publishing logs: github.com/badtechnologies/bdsh/actions/runs/38527617013/attempts/1

Artifact

Subject: bdsh-0.7.2.tar.gz
SHA-256 checksum: c370eb682c5f1956a7e72c53470dd1112d9f870f3d4395d9f3dd573411d5ea4a Verifying attestations

Release files / bdsh-0.7.2-py3-none-any.whl

Download URL	bdsh-0.7.2-py3-none-any.whl
Size	27.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2928889138f063153813d8b3ac212e7c450ed19bd9ac1a3e18a1492be71bff78`
BLAKE2b-256 checksum How to use checksums	`a68ad6935f90f338db5283e6ff49a8be5d1a5541a56cc85c3f577b9b0ee776a0`
Upload date	Oct 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/badtechnologies/bdsh
Publishing commit: github.com/badtechnologies/bdsh/tree/d0654fd4026360d2e8c2d84b9f86de10fe076330

Workflow

Publishing configuration: github.com/badtechnologies/bdsh/blob/d0654fd4026360d2e8c2d84b9f86de10fe076330/.github/workflows/publish.yml
Publishing logs: github.com/badtechnologies/bdsh/actions/runs/38527617013/attempts/1

Artifact

Subject: bdsh-0.7.2-py3-none-any.whl
SHA-256 checksum: 2928889138f063153813d8b3ac212e7c450ed19bd9ac1a3e18a1492be71bff78 Verifying attestations