Skip to content

rohankapoorcom/drivetracker

Repository files navigation

Drive Tracker

Build Status Coverage Status Documentation Status

Catalogue all of your hard drives with a beautiful web-based tool. Docker package coming soon.

Demo


Play with Drive Tracker on it's demo site

Features


  • Responsive web design - for use on desktop and mobile browsers
  • Designed using Bootstrap 3
  • Built with Django
  • Runs wherever Python does
  • Search by any field
  • Input and store all the data you have about each of your harddrives
  • All fields are optional

Requirements


  • Python 2.7
  • SQL Server (PostgreSQL recommended)

Optional


  • Nginx (or other reverse proxy running in front of gunicorn)

Installation


  1. Open a terminal and go to the folder where you want to install (cd /opt/dt)
  2. Download and unzip the latest build to that directory (/opt/dt/)
  3. Create a virtualenvironment and use pip to install all of the required packages
virtualenv venv
source venv/bin/activate
sudo apt-get install libpq-dev python-dev (ubuntu only)
pip install -r requirements.txt
  1. Copy drivetracker/settings/example.py to drivetracker/settings/local.py and fill in your configuration details
  • Make sure to disable debug by setting DEBUG = False in local.py
  • Make sure to provide correct database settings or the app won't start
  1. Migrate the database python manage.py migrate
  2. Start Drive Tracker by executing gunicorn -b 0.0.0.0:8000 drivetracker.wsgi
  3. You can access Drive Tracker from a web browser at yourip:8000
  4. Configure Gunicorn to start automatically

Contributing


  • Fork the project repository
  • Make all of your changes in a specific branch on your fork
  • Make sure your changes confirm to the Style Guide for Python Code (PEP8)
  • Open a pull request

Sort your Imports

isort -rc --atomic .

Check for PEP-8 compatability

flake8 drivetracker

Generating Documentation

To autodoc/generate templates: sphinx-apidoc -f -o docs/ drivetracker/ drivetracker/*/migrations drivetracker/settings

To build the html pages: cd docs; make html

License

Please see LICENSE

About

Catalogue all of your hard drives with a beautiful web-based tool

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published