Skip to main content

Creates index.html for directory contents shared publicly on Dropbox. Easily share whole content of the directory without the need to send separate links for each file.

Project description

https://img.shields.io/pypi/v/dropbox-index.svg https://img.shields.io/pypi/pyversions/dropbox-index.svg tests Ruff Code style: Black https://img.shields.io/badge/skeleton-2023-informational

Introduction

dropbox-index creates index.html for directory contents shared publicly on Dropbox. Easily share whole content of the directory without the need to send separate links for all the shared files.

After installing, just run this Python script with directory as an argument (and add -R as an option if to include subdirectories):

Usage: dropbox-index [options] DIRECTORY

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  -R, --recursive       Include subdirectories [default: False]
  -T TEMPLATE, --template=TEMPLATE
                        Use HTML file as template

ATTENTION: Script will overwrite any existing index.html file(s)!

Example: dropbox-index.py -R -T template.html ~/Dropbox/Public/show will generate index.html for directory (and subdirectories if run in recursive mode). Hidden files (filenames starting with ‘.’) are automatically omitted.

If a directory contains a file with dir-info in it’s name (dir-name, dir-name.txt, dir-name.html, - all these names are valid) the contents of the file will be used in the index.html as and additional information about directory content.

Click on the table’s headings to sort files by name, size, or date (in ascending and descending order).

Template

Templates can be used to generate custom index.html files. Selected template is used to generate all pages, including subdirectories if the script is run in recursive mode.

Templates are just regular HTML files. CSS styles and JavaScript code will be automatically injected. The table with the files list will be injected in place of %(FILES)s.

Use (names are case sensitive!):

  • %(FILES)s: must be included or the files list won’t be injected!

  • %(FAVICON)s: place it inside <head> if you want Dropbox-favicon to be used

  • %(ENCODING)s: system encoding identified by the script

  • %(PATH)s: name of the directory

  • %(DIR_INFO)s: place for additional directory information (from dir-info files Screenshot).

Icons

dropbox-index uses icons from famfamfam’s “Silk” icon set

Acknowledgements

Wojciech ‘KosciaK’ Pietrzok was the original author.

Tommy MacWilliam introduced the template system.

Jason R. Coombs ported the project to Python 3 and maintains it.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dropbox-index-0.6.0.tar.gz (28.8 kB view details)

Uploaded Source

Built Distribution

dropbox_index-0.6.0-py3-none-any.whl (26.6 kB view details)

Uploaded Python 3

File details

Details for the file dropbox-index-0.6.0.tar.gz.

File metadata

  • Download URL: dropbox-index-0.6.0.tar.gz
  • Upload date:
  • Size: 28.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for dropbox-index-0.6.0.tar.gz
Algorithm Hash digest
SHA256 a5a59f9a699053aad63b32913da4c93f1a6944a5581e5eb4892a10bda6babaf4
MD5 1cb9efa6a6e86a74f73902f29fd648db
BLAKE2b-256 31c3def5bb1384b44d91a35cf6f31cf151730c5b79f5c7dcef1265ab22aa5192

See more details on using hashes here.

File details

Details for the file dropbox_index-0.6.0-py3-none-any.whl.

File metadata

File hashes

Hashes for dropbox_index-0.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 de19f87f40cb9fc9424da11b7b72ba7d178fee5aecac008ce31bf5640d1b8b1c
MD5 5f70396c55aba6ebae5673ca351424e2
BLAKE2b-256 bc221af0eb7da2cb5f76b7866be6247b1199bbe2b69a3f212bcf1e12dcf1903e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page