Skip to content

pasinduljay/Sharepoint-Video-Downloader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 SharePoint Video Downloader

Overview

This is a self-hosted SharePoint video downloader that allows users to download SharePoint-hosted videos, even when they have view-only permissions. The project leverages Flask, Docker, and Nginx reverse proxy to provide a secure and efficient solution.

🔧 Features

  • 📥 Download view-only SharePoint videos
  • 🔀 Reverse Proxy (Nginx) for secure access
  • 🚀 Dockerized deployment with Docker Compose
  • 🔄 CI/CD integration using GitHub Actions
  • 🔒 SSL encryption support for secure connections
  • 📂 File browser UI for managing downloaded files

🏗 Tech Stack

  • 🐍 Flask (API Backend)
  • 🔥 SocketIO (Real-time updates)
  • 🐳 Docker & Docker Compose (Containerization)
  • 🌐 Nginx Reverse Proxy (Secure access)
  • 🚀 GitHub Actions (CI/CD automation)
  • 🖥 Ubuntu VPS (Hosting environment)

📜 Prerequisites

  1. Ubuntu VPS with:
    • Docker
    • Docker Compose
    • Git
  2. Domain name pointing to your VPS IP
  3. SSL certificates (from Cloudflare or similar)
  4. GitHub account for deployment

🚀 Deployment Guide

1️⃣ Domain Configuration

  1. Point your domain to your VPS IP address
  2. Set up Cloudflare or other SSL provider
  3. Obtain SSL certificate and private key

2️⃣ GitHub Repository Setup

  1. Fork or clone this repository
  2. Configure GitHub Secrets:
    • INSTANCE_IP: Your VPS IP
    • INSTANCE_USERNAME: VPS SSH username
    • SSH_PRIVATE_KEY: SSH private key for deployment
    • GHUB_USERNAME: Your GitHub username
    • TOKEN: GitHub personal access token
    • SSL_CERT: SSL certificate content
    • SSL_KEY: SSL private key content

3️⃣ Nginx Configuration

Edit the domain names in:

  • nginx/reverse-proxy/app.conf: Change app.techdevops.live to your app domain
  • nginx/reverse-proxy/file.conf: Change files.techdevops.live to your file browser domain

4️⃣ Deployment

The application will automatically deploy when you push to the main branch.

To verify deployment:

  1. Check GitHub Actions tab for deployment status
  2. Verify containers are running on your VPS:
docker ps

5️⃣ Access

  • Web Interface: https://your-app-domain
  • File Browser: https://your-file-domain

🔒 Security Notes

  • All traffic is encrypted using SSL/TLS
  • Nginx reverse proxy provides additional security
  • Containers run in isolated network
  • Regular updates via automated deployment

📞 Support

Create an issue on GitHub for:

  • Deployment questions
  • Configuration help
  • Bug reports

📜 License

This project is licensed under the MIT License.



💰 You can help me by Donating

Coding

Buy Me A Coffee Buy Me A Coffee

About

A secure self-hosted solution for downloading SharePoint videos with view-only permissions. Built with Flask, Docker, and Nginx reverse proxy for seamless deployment and efficient video management.

Resources

License

Stars

Watchers

Forks

Contributors