Skip to content

gty5678/skfjiwelkasd

DarkEye

Insight and order

A fully local personal media library, metadata editor, relationship analyzer, and archive browser.


README · English README · 繁體中文 README · 日本語

Python Framework Platform License GitHub last commit GitHub release GitHub Repo stars


📖 Docs 🎥 Video 🌐 Website 💬 Discord

Legal and compliant useDownload and usageFeaturesScreenshotsPrivacy and dataMigration and importDevelopmentCommunityRelated projects


Legal and compliant use

  • This tool is for managing data and metadata that you lawfully own, are authorized to handle, or may otherwise process in compliance with applicable law.
  • When using this tool, follow the laws and regulations in force in your jurisdiction.
  • Do not use this tool for unlawful scraping, infringing distribution, bypassing site access controls, or processing other people’s data without authorization, among other abuses.
  • Third-party sites, APIs, and access rules are governed by their platform terms; you are responsible for compliance.
  • Do not download third-party software indiscriminately.
  • This project is a general-purpose local tool for managing data you lawfully own or are authorized to handle.
  • It must not be used for infringing distribution, fraud, access-control circumvention, unauthorized scraping, or other illegal activities.
  • The project will never private-message you to ask for verification codes, remote control, or money. Download only from official release channels and verify file hashes or signatures when provided.

Download and usage

Download, extract, and run the executable. Browser extensions are shipped with the app under the extensions directory. Install one extension for your browser, as described in the docs below.

Browser extension

👉 Docs: install the browser extension

You usually do not need a separate extension download unless the extension is updated on its own.

Download Chrome/Edge extension    Download Firefox extension

User guide

👉 Docs: usage

Versions and updates

👉 FAQ: updates and migration

Settings can check for and download updates to the application itself. The app does not auto-update the browser extension; extensions in the extensions folder are updated with the app, and you need to reload the extension in the browser manually. You can also download extensions from Releases.

When migrating to a new version, update the browser extension as well.


Features

Implemented

Feature Description Status
Data management CRUD for media items, people, tags, and related data
Personal records Manual add and CRUD for custom record entries
Analysis and charts Charts and analysis views (some areas still in progress)
Skeuomorphic DVD shelf DVD-style display and collection experience
Filters and views Filtered work listing pages
Relationship graph Explore relationships; ~60 fps with ~10k nodes
Translation LLM translation and one-click overwrite
Local video links Link local video files into the database when present
Backups Backup system for local archive and restore
Theming Theme switching (3D scene does not fully follow light/dark yet)
Auto-update Check and download app updates
mdcz NFO import NFO import from mdcz
Jvedio NFO import Jvedio export NFO (testing)

Planned / in progress

Feature Description Status
NFO export After consensus; field mapping varies across tools and is not complete 🔄

Long-term plans and more detail: Changelog and roadmap (rolling; not a fixed schedule).


Migration and import

mdcz NFO import

NFO import from mdcz is supported.

👉 Docs: mdcz NFO

Jvedio migration

👉 Docs: Jvedio


Privacy and data

  • Data and networking: By default, data lives next to the app in data/ (database, config, covers, avatars, etc.). The app does not proactively upload your local library to third parties. Network use mainly comes from scraping, resource fetches, optional update downloads (Cloudflare R2), and translation (Google or a self-hosted LLM API you configure). You enable third-party services and are responsible for compliance.

Screenshots

Force-directed graph

Charts


Development

The stack is PySide6 / Qt Quick 3D, SQLite, local FastAPI, browser extensions, and a C++ force-directed graph for performance.

To develop locally, follow the guide below to run the app.

👉 Development docs


Community

Questions or ideas? Join Discord: Join the community

  • New users: Ask if something in the docs is unclear; the online docs are updated over time.
  • Early access: New features, progress, and pre-releases are discussed on Discord first.
  • Influence the roadmap: Come discuss what you would like to see.

Related projects


License

This project is released under the GNU General Public License v3.0.


Contributors

Contributors
DarkEye — a local media shelf, under your control.

About

Local desktop app for media collection & library management: skeuomorphic DVD shelves, force‑directed relationship graphs, and analytics.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors