{"id":33224444,"url":"https://github.com/beelzebub2/dndtools","last_synced_at":"2026-03-03T13:06:51.636Z","repository":{"id":289178767,"uuid":"970376814","full_name":"Beelzebub2/DnDTools","owner":"Beelzebub2","description":"Unified Stash \u0026 Quest Manager: Cross-character item search and real-time objective tracking.","archived":false,"fork":false,"pushed_at":"2026-02-27T01:06:01.000Z","size":209138,"stargazers_count":5,"open_issues_count":4,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-27T08:47:14.972Z","etag":null,"topics":["darkanddarker","itemsearch","organizer","python","pywebview","search","stash"],"latest_commit_sha":null,"homepage":"https://dndtools.rrmtools.uk","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Beelzebub2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-21T23:28:21.000Z","updated_at":"2026-02-27T01:06:04.000Z","dependencies_parsed_at":"2025-10-09T00:02:38.873Z","dependency_job_id":null,"html_url":"https://github.com/Beelzebub2/DnDTools","commit_stats":null,"previous_names":["beelzebub2/dndtools"],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/Beelzebub2/DnDTools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Beelzebub2%2FDnDTools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Beelzebub2%2FDnDTools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Beelzebub2%2FDnDTools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Beelzebub2%2FDnDTools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Beelzebub2","download_url":"https://codeload.github.com/Beelzebub2/DnDTools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Beelzebub2%2FDnDTools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29966684,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T09:33:09.965Z","status":"ssl_error","status_checked_at":"2026-03-01T09:25:48.915Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["darkanddarker","itemsearch","organizer","python","pywebview","search","stash"],"created_at":"2025-11-16T16:00:38.730Z","updated_at":"2026-03-01T10:00:56.172Z","avatar_url":"https://github.com/Beelzebub2.png","language":"Python","funding_links":["https://www.buymeacoffee.com/DnDTools"],"categories":[],"sub_categories":[],"readme":"# Dark and Darker Tools\n\n## 🎮 Demo\n\n\u003cp align=\"center\"\u003e\n  \u003cvideo src=\"https://github.com/user-attachments/assets/100d069c-3b83-4177-a7ff-7760b1cd092d\" controls autoplay loop muted width=\"100%\"\u003e\u003c/video\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/python-3.7+-blue.svg\" alt=\"Python\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-MIT-green.svg\" alt=\"License\"\u003e\n  \u003ca href=\"https://github.com/Beelzebub2/DnDTools/releases/\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/Beelzebub2/DnDTools?include_prereleases\u0026label=version\" alt=\"Version\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/Beelzebub2/DnDTools/actions/workflows/build-and-release.yml\"\u003e\u003cimg src=\"https://github.com/Beelzebub2/DnDTools/actions/workflows/build-and-release.yml/badge.svg\" alt=\"Build Status\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\nA tool to capture and generate visual previews of Dark and Darker stash contents and organize them.\n\n🌐 **Website:** [https://dndtools.rrmtools.uk](https://dndtools.rrmtools.uk)  \n💬 **Discord:** [Join our community](https://discord.gg/X8FuqR2cq6)  \n❓**Wiki** [FAQ](https://github.com/Beelzebub2/DnDTools/wiki)\n\n## ⚠️ Disclaimer\n\nThis project is not affiliated with, endorsed by, or connected to IRONMACE Co., Ltd. or Dark and Darker in any way. This is a fan-made tool for educational purposes only.\n\nAll game content and materials are trademarks and copyrights of IRONMACE Co., Ltd. or its licensors. All rights reserved.\n\n## 🚀 Features\n\n- Captures Dark and Darker network data for stash and inventory\n- Visualizes your characters, stashs and inventory in a clean layout\n- Allows sorting of your stashes using inventory for temporary storage\n- Includes a search box to quickly find items across all characters\n\n## 📋 Requirements\n\n- Python 3.7+ [Download](https://www.python.org/downloads/)\n- For versions **2.1.4 and earlier**: Npcap [Download](https://npcap.com/#download)\n- For versions **after 2.1.4**: Wireshark [Download](https://www.wireshark.org/download.html)\n\n## 🔧 Installation\n\n### Windows (recommended)\n\n1. Download the latest `DnDTools-Setup-\u003cversion\u003e.exe` from the [releases page](https://github.com/Beelzebub2/DnDTools/releases).\n2. Run the installer and follow the prompts. The application will be available from the Start Menu (and optionally on the desktop).\n\n### Development setup\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/Beelzebub2/DnDTools.git\ncd DnDTools\n```\n2. Navigate to the UI folder and install required dependencies:\n```bash\npip install -r UI/requirements.txt\n```\n\n## 📖 Usage\n1. Start Dark and Darker\n2. Navigate to the UI folder and run the application::\n```bash\ncd UI\npython app.py\n```\n3. Make sure packet capture is enabled.\n4. From the character selection screen, select the character you want to capture.\n5. Open your stash in-game. Your character’s stash and inventory will appear in the Characters tab.\n\n## 📦 Building the Windows Installer\n\nYou can produce a signed-ready Windows installer using Inno Setup:\n\n1. Install [Inno Setup 6](https://jrsoftware.org/isinfo.php) and ensure `ISCC.exe` is on your `PATH` or set the `ISCC_PATH` environment variable.\n2. From the project root, run:\n\n```cmd\ninstaller\\build_installer.bat\n```\n\nThis command will rebuild the standalone executable with PyInstaller, synchronize the installer metadata with the application version, and emit `DnDTools-Setup-\u003cversion\u003e.exe` in the `dist\\` directory.\n\n\u003e Need to stamp a one-off version (for example, to match a GitHub release tag)? Set `DNDTOOLS_RELEASE_VERSION` before running the installer script:\n\u003e\n\u003e ```cmd\n\u003e set DNDTOOLS_RELEASE_VERSION=v3.6.1\n\u003e installer\\build_installer.bat\n\u003e ```\n\u003e\n\u003e If the build should be treated as a dev/Test release, also set `DNDTOOLS_RELEASE_CHANNEL`:\n\u003e\n\u003e ```cmd\n\u003e set DNDTOOLS_RELEASE_VERSION=v3.6.1\n\u003e set DNDTOOLS_RELEASE_CHANNEL=dev\n\u003e installer\\build_installer.bat\n\u003e python scripts\\generate_update_manifest.py --release-tag v3.6.1 --version v3.6.1 --channel dev\n\u003e ```\n\u003e\n\u003e The GitHub Actions workflow now sets both variables automatically from the `workflow_dispatch` inputs (`tag` and `channel`), so the CI-built installer and manifest always match what you typed on the Actions form.\n\n\u003e The GitHub Actions release pipeline invokes the same script and attaches the generated installer to each tagged pre-release.\n\n## ⚙️ Configuration\n### Updating Protobuf Files After a Game Update\n\nAfter a **Dark and Darker** update, you will need to run:\n```\nUI\\networking\\extract.bat\n```\nto grab the fresh `.proto` files from the game binary.\n\n\u003e **Important:**  \n\u003e Before running, update the path inside `extract.bat` if your game is installed somewhere other than the default.  \n\u003e The default path is:\n\u003e ```\n\u003e C:\\Program Files\\IRONMACE\\Dark and Darker\\DungeonCrawler\\Binaries\\Win64\\DungeonCrawler.exe\n\u003e ```\n\nWe will try to keep the `.proto` files in the repository updated, but if they are outdated, you can use this script to generate the latest ones yourself.\n\n### Opt into development/Test builds\n\nIf you want to help test unreleased builds tagged as `Test-*` on GitHub:\n\n1. Open the app and go to **Settings → Updates**.\n2. Enable **Opt into Test builds** and save.\n3. The built-in updater (and auto-update checks) will now look for the newest `Test-` prerelease instead of the latest stable release.\n\nYou can switch back at any time by unchecking the option; update checks will immediately return to the stable channel.\n\n## 🛡️ Legal\n\nThis project:\n- Does not modify any game files\n- Does not interact with the game process\n- Only captures and analyzes network traffic\n- Is provided \"AS IS\" without warranty of any kind\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## 🙏 Acknowledgments\nthanks to:\n- **Kokkor** on Discord for their help with protobuf and packet capture.\n- **Anders** on Discord for their help with this project and for allowing us to use custom models.\n- [Darkerdb](https://darkerdb.com/) for the amazing api.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## 💬 Support\n\nFor support or questions, please [open an issue](https://github.com/Beelzebub2/darkanddarker-stash-preview/issues) on GitHub.\n\n## 📝 TODO\n```diff \n- Show crafting usage for items\n```\n---\n*Remember to always comply with Dark and Darker's Terms of Service while using this tool.*\n\n### Support us\n\n[\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" height=\"80\" /\u003e](https://www.buymeacoffee.com/DnDTools)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeelzebub2%2Fdndtools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbeelzebub2%2Fdndtools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeelzebub2%2Fdndtools/lists"}