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 supports DLsite works with RJ, BJ, and VJ codes - Voice / ASMR, Games, Manga, Music, etc.

Features

☰ Library Management

• Add works: Fetch metadata from DLsite, import multiple DLsite works at once, or create custom entries with your own details and images.
• Edit works: Edit work information and add details like current status, score, start and finish dates, priorities, and re-listens.
• Tag Library: Add your own tags and organize them into groups. Add parent/child relationships, customize tag and group colors, control visibility, and change their order on the Index.
• Search and Filter: Search, filter, and sort your library.
• Image Viewer: View saved covers and sample images.

⇄ Updates & Transfers

• Refetch: Check DLsite for updated metadata, covers, and sample images, and review changes before applying them.
• Import and Export: Export and Import your entire library or selected works, images, Tag Library data, and Options using multipart ZIP files. Review imported changes before applying them.

⚙ Customization & Settings

• Display options: Customize pagination, search behavior, table width, columns, and how Notes and Tags are displayed.
• Field layouts: Configure field visibility and order for filters, sort menus, add and edit forms.
• UI Wording: Choose general or content-focused UI wording for listening, reading, games, video, music, and artwork.
• Authentication: Optional single-user authentication.
• Languages: English, Japanese, and partial Traditional Chinese support. The Japanese UI is mostly auto-translated, so quality may vary. Fetched tags, titles, and other language-specific DLsite metadata are available in English and Japanese.

Screenshots

Index

Quick Add, Options, Tag Library

Quick Start (requires Docker Compose 2.34.0+)

1) Run this command

docker compose -f oci://ghcr.io/arednel/dlsite-list:latest up -d -y

2) After startup

• DLSite List is available at: http://localhost:8080
• 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
• A web server configured to run PHP, for example Apache or Nginx
• Composer
• MySQL 8
• Python 3.14.6 (tested with this version) and pip

Manual installation is tested with WAMP on Windows. Follow the manual installation guide for requirements and setup instructions.

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 -f compose.dev.yaml --profile test run --rm --build tests

Documentation

• Configuration
• Architecture
• Testing

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

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.