https://github.com/spacegears/hdml

A simple Python script to generate a HTML overview of your (media) files
https://github.com/spacegears/hdml

archive datahoarder directory-lister index overview

Last synced: about 2 months ago
JSON representation

A simple Python script to generate a HTML overview of your (media) files

• Host: GitHub
• URL: https://github.com/spacegears/hdml
• Owner: spacegears
• Created: 2024-11-25T19:16:15.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-11-09T14:25:41.000Z (7 months ago)
• Last Synced: 2025-12-09T16:57:07.535Z (6 months ago)
• Topics: archive, datahoarder, directory-lister, index, overview
• Language: Python
• Homepage:
• Size: 39.1 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# hdml

hard disk media list

## What is this thing?

Well, the name isn't quite accurate but I'll explain: you have (media) files in their dedicated folders - including subfolders - with an image file as preview (or cover art) right next to each one of them. You want to have a simple overview of what's in your folder(s), perhaps a grid of images that you can scroll through in your browser. This simple `Python` script will generate that `HTML` file for you. No dependencies and around 100 lines of code, with some `CSS` included to make the result responsive.

Example: preferred file/folder structure

    [Root Folder]

    ├── [Example Folder 1]

    │   ├── File1.jpg

    │   └── File1.mp4

    |

    ├── [Example Folder 2]

    │   ├── File2.jpg

    │   └── File2.mp4

    |

    ├── [Example Folder 3]

    │   ├── File3.jpg

    │   └── File3.mp4

    |

    └── [Example Folder 4]

        ├── File4.jpg

        ├── File4.mp4

        |

        └── [Example SubFolder 1]

            ├── File5.jpg

            └── File5.mp4

## How to use?

    python3 hdml.py

Note:

* Hover an image to see the filename

* You might want to use images with the same size, or at least the same ratio

* Items are ordered by the names of the images

## This is too simple

That's for a good reason, less is more. For something more advanced, you might want to check out [Snap2HTML](https://github.com/rlv-dan/Snap2HTML) (Windows) or [LinuxDir2HTML](https://github.com/homeisfar/LinuxDir2HTML) (Linux).