DLSite List

DLSite List is a single-user, self-hosted personal DLsite library for organizing your collection, inspired by MyAnimeList's "Cherry Blossom" theme.

It's mainly made for ASMR titles, and quite a lot of the UI uses that wording, but it can also be used with other DLsite works that have an RJ code - Games, Manga, Music etc.

Features

• Fetch work metadata directly from DLsite or add them manually.
• Edit work information and add things like current status, score, start and finish dates, priorities and re-listens.
• Add your own tags and organize them into groups. Add parent/child relationships, tag and tag-group colors, visibility, and Index ordering in the "Tag Library".
• Search, filter, and sort your library.
• View saved cover and sample images with the "Image Viewer".
• Refetch current metadata, covers and sample images from DLsite and review changes before applying them.
• Customize pagination, search behavior, table width, columns, Notes and Tags display, and tag ordering.
• Configure field visibility and order for filters, sort menus, Quick Add, Custom Quick Add, and Edit forms.
• Optional single-user authentication.
• English and Japanese UI with separate English and Japanese fetched tag "sets". Japanese UI was mostly created using auto-translate, so quality may vary.

Screenshots

Index

Quick Add, Options, Tag Library

Quick Start (requires Git and Docker Compose)

1) Run these commands

git clone https://github.com/Arednel/DLSite-List.git

cd DLSite-List

docker compose --env-file docker/.env.docker up --build -d

2) After startup

• DLSite List available at: http://localhost:8080
• Optional phpMyAdmin: http://localhost:8888 after enabling it in compose.yaml (disabled by default).
• Authentication is disabled by default. To add username and password, open Options -> Authentication and turn on Require administrator login.

Manual installation process

Requirements

• PHP 8.3
• Composer
• MySQL 8
• Python 3.14.6 (tested with this version) and pip

1) Create .env from .env.example then run from the project root:

composer install
php artisan key:generate
php artisan migrate
php artisan storage:link

2) Create and activate the venv:

python -m venv python/venv

Activate it with:

• Windows: python\venv\Scripts\activate
• Linux/macOS: source python/venv/bin/activate

3) Install Python packages:

pip install -r python/requirements.txt

4) Run workers

php artisan queue:work

Running tests

Create .env.testing from .env.testing.example, set test DB credentials, then run:

php artisan test

To run the test suite inside Docker with a dedicated test database:

docker compose --env-file docker/.env.docker --profile test run --rm --build tests

Additional docs

• Configuration
• Architecture
• Testing

Contributing

Contributions are very welcome.

License

Distributed under the terms of the MIT License, DLSite List is free and open-source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Acknowledgements

• bhrevol/dlsite-async — used to retrieve DLsite work metadata.