simple-viewer

Simple Viewer is a small learning project designed to work as a static file server with accompanying viewing methods.

These viewing methods are intended to be as simple as possible, mostly focusing on video.

Planned are text files, source code files, PDFs, and pictures. Everything else will be served as direct browser links (the browser handles all viewing) or as downloads.

The project will be built in Django (as well as HTML/CSS/JS), my first ever project in the framework, so expect poorer standards, mishaps, some complex bugs (resolved with needlessly complex solutions) and such.

Screenshots

Viewing the index, showing all available directories

Browsing a directory with thumbnails and file information

The Add Directory dialog

Features

• Filterable directories with options for recursive file finding
  • Directories can be anywhere the application has read access to
• UUID4 based directory URLs
• Fast video and picture thumbnailing
• Sleek dark theme with neon turquoise primary

To-do

• Directory sorting
• Javascript based image/video hover to view
• Real-time websockets to view background thumbnailing processes
• Better multi-viewport support through Bulma
• Better icon alignment using Flexbox
• Better font choices
• Fixup Django project organization issues
  • Ensure all submission URLs use Forms & POST
• Better non-media support for files in directory listings

Setup

git clone https://github.com/Xevion/simple-viewer.git
pip install -r requirements.txt

Additionally, during development, you will want Sass files to be updated.

In a separate terminal, run this command to automatically generate .css files from .scss files when they are edited.

cd ./viewer/static/css/
sass --watch .

Running simple-viewer

python manage.py runserver