Skip to content

1CDN/Terabox-Web

Β 
Β 

Repository files navigation

πŸš€ TeraBox Web - Professional File Downloader

TeraBox Web Version React TypeScript Tailwind CSS Netlify

Fast, secure, and reliable file downloads from TeraBox with no limits.

🌐 Live Demo β€’ πŸ“– Documentation β€’ πŸ™ GitHub


πŸ“– Overview

TeraBox Web is a modern, professional web application that allows you to download files from TeraBox with direct download links and proxy support. Built with cutting-edge technologies including React 18, TypeScript, and Tailwind CSS, it features a beautiful glassmorphism UI, dark/light mode, and comprehensive API documentation.

🎯 Key Benefits

  • βœ… No Download Limits - Download files of any size without restrictions
  • βœ… Fast & Reliable - Serverless architecture for optimal performance
  • βœ… User-Friendly - Intuitive interface with step-by-step guidance
  • βœ… Mobile Responsive - Works perfectly on all devices
  • βœ… Professional Design - Modern UI with smooth animations
  • βœ… API Ready - Full REST API for developers

πŸš€ Quick Start

🌐 Try It Now

Visit https://terasnap.netlify.app/ to start downloading files immediately!

πŸ› οΈ For Developers

# 1. Clone the repository
git clone https://github.com/Itz-Ashlynn/Terabox-Web.git
cd Terabox-Web

# 2. Install dependencies
npm install

# 3. Start development server
npm run dev

# 4. Open http://localhost:5173

πŸ“‹ Table of Contents


✨ Features

🎯 Core Features

Feature Description
πŸ”— Direct Downloads Get direct download links from TeraBox URLs
πŸ›‘οΈ Proxy Support External proxy integration for faster downloads
πŸŒ™ Dark/Light Mode Beautiful theme switching with system preference detection
πŸ“± Mobile Responsive Optimized for all devices and screen sizes
⚑ Fast & Reliable Serverless architecture for optimal performance
πŸͺ Cookie Management Easy NDUS cookie setup with detailed guide

🎨 Design & User Experience

Feature Description
🎭 Modern UI/UX Clean, professional interface with smooth animations
✨ Glassmorphism Effects Beautiful backdrop blur and transparency effects
πŸ“± Responsive Design Mobile-first approach with perfect scaling
β™Ώ Accessibility ARIA labels, keyboard navigation, and screen reader support
⏳ Loading States Elegant loading animations and error handling

πŸ”§ Technical Features

Feature Description
🌐 REST API Full-featured API with comprehensive documentation
πŸ”„ CORS Handling Serverless functions to bypass browser limitations
πŸ›‘οΈ Error Handling Robust error management with user-friendly messages
πŸ”’ Type Safety Full TypeScript implementation
πŸš€ SEO Optimized Meta tags, Open Graph, and mobile optimization

🎯 How to Use

πŸ“± Web Interface (Recommended)

  1. 🌐 Visit the Website

  2. πŸͺ Setup Your Cookie

  3. πŸ“Ž Enter TeraBox URL

    • Paste your TeraBox share link in the input field
    • Example: https://1024terabox.com/s/1abc123def456
  4. ⬇️ Download Your File

    • Choose between direct download or proxy download
    • Click download and enjoy your file!

πŸ”§ API Usage (For Developers)

Base URL

https://terasnap.netlify.app

Example Request

curl -X POST "https://terasnap.netlify.app/api/download" \
  -H "Content-Type: application/json" \
  -d '{
    "link": "https://1024terabox.com/s/1abc123def456",
    "cookies": "ndus=YourCookieValueHere"
  }'

Example Response

{
  "file_name": "example_file.zip",
  "download_link": "https://direct-download-link.com/file",
  "thumbnail": "https://thumbnail-url.com/thumb.jpg",
  "file_size": "125.50 MB",
  "size_bytes": 131621888,
  "proxy_url": "https://terabox.ashlynn.workers.dev/proxy?url=encoded_url&file_name=example_file.zip&cookie=encoded_cookie"
}

πŸͺ Cookie Setup Guide

πŸ“‹ Step-by-Step Instructions

πŸ” Method 1: Using Cookies Editor Extension (Recommended)

Step 1: Install Extension

Step 2: Login to TeraBox

  1. Go to https://terabox.com
  2. Login to your account

Step 3: Activate Session

  1. Find any video file on TeraBox
  2. Start playing it (this activates your session)

Step 4: Extract Cookie

  1. Click the Cookies Editor extension icon
  2. Search for cookie named ndus
  3. Copy the entire cookie value

Step 5: Use in Application

  • Paste the cookie value in the format: ndus=YOUR_COPIED_VALUE
πŸ”§ Method 2: Using Browser Developer Tools

Step 1: Open Developer Tools

  • Press F12 or right-click β†’ "Inspect"

Step 2: Navigate to Cookies

Step 3: Find NDUS Cookie

  • Look for cookie named ndus
  • Copy its value

Step 4: Use in Application

  • Enter: ndus=YOUR_COPIED_VALUE

⚠️ Important Tips

  • πŸ”„ Cookie Expiration: NDUS cookies expire after some time. Generate a new one if you get authentication errors
  • πŸ‘‘ Account Type: Both free and premium accounts work, but premium offers faster speeds
  • πŸ”’ Security: Never share your NDUS cookie with others

πŸ” API Documentation

πŸ“Š Request/Response Format

Method Endpoint Content-Type
POST /api/download application/json

πŸ“ Request Parameters

Parameter Type Required Description
link string βœ… TeraBox share URL
cookies string βœ… TeraBox ndus cookie value

πŸ“€ Response Fields

Field Type Description
file_name string Original filename from TeraBox
download_link string Direct download URL from TeraBox
thumbnail string Preview image URL (if available)
file_size string Human-readable file size
size_bytes number File size in bytes
proxy_url string External proxy download URL

πŸ”’ HTTP Status Codes

Code Description
200 βœ… Success - File information retrieved
400 ❌ Bad Request - Invalid parameters
404 ❌ Not Found - Endpoint not found
500 ❌ Server Error - Internal error occurred

πŸ› οΈ Installation

πŸ“‹ Prerequisites

  • Node.js (v18 or higher) - Download here
  • npm or yarn - Package managers
  • Git - Version control

πŸš€ Local Development Setup

  1. Clone Repository

    git clone https://github.com/Itz-Ashlynn/Terabox-Web.git
    cd Terabox-Web
  2. Install Dependencies

    npm install
    # or
    yarn install
  3. Start Development Server

    npm run dev
    # or
    yarn dev
  4. Open Browser

    http://localhost:5173
    

πŸ—οΈ Build for Production

npm run build
# or
yarn build

πŸ› οΈ Technology Stack

🎨 Frontend

  • βš›οΈ React 18 - Modern React with hooks and functional components
  • πŸ“˜ TypeScript - Type-safe development with full IntelliSense
  • 🎨 Tailwind CSS - Utility-first CSS framework for rapid UI development
  • 🧭 React Router - Client-side routing for SPA navigation
  • 🎭 Lucide React - Beautiful, customizable icons

☁️ Backend

  • 🌐 Netlify Functions - Serverless functions for API endpoints
  • πŸ”„ CORS Handling - Cross-origin request management
  • πŸ›‘οΈ Proxy Integration - External proxy service integration

πŸ”§ Development Tools

  • ⚑ Vite - Fast build tool and development server
  • πŸ“¦ npm/yarn - Package management
  • πŸ”§ ESLint - Code linting and formatting
  • 🎯 PostCSS - CSS processing and optimization

🌐 Deployment

  • πŸš€ Netlify - Hosting, CI/CD, and serverless functions
  • πŸ”„ GitHub Actions - Automated deployment and testing
  • πŸ“ˆ Analytics - Performance monitoring and user analytics

🌐 Deployment

πŸš€ Netlify Deployment (Recommended)

  1. Fork Repository

  2. Connect to Netlify

    • Login to Netlify
    • Click "New site from Git"
    • Select your forked repository
  3. Configure Build Settings

    • Build command: npm run build
    • Publish directory: dist
  4. Deploy

    • Netlify will automatically deploy your site

πŸ“ Manual Deployment

  1. Build Project

    npm run build
  2. Deploy dist folder to your hosting provider


🀝 Contributing

We welcome contributions! Here's how you can help:

πŸš€ Getting Started

  1. Fork the repository
  2. Create a feature branch
    git checkout -b feature/amazing-feature
  3. Make your changes
  4. Commit your changes
    git commit -m 'Add amazing feature'
  5. Push to the branch
    git push origin feature/amazing-feature
  6. Open a Pull Request

πŸ“‹ Development Guidelines

  • Code Style: Follow existing TypeScript and React patterns
  • Testing: Ensure your changes don't break existing functionality
  • Documentation: Update documentation for new features
  • Responsive: Test on mobile devices and different screen sizes
  • Accessibility: Maintain ARIA labels and keyboard navigation

🎯 Areas for Contribution

  • πŸ› Bug Fixes - Report and fix bugs
  • ✨ New Features - Add new functionality
  • 🎨 UI/UX Improvements - Enhance design and user experience
  • πŸ“– Documentation - Improve docs and guides
  • πŸ”§ Performance - Optimize speed and efficiency
  • 🌐 Internationalization - Add multi-language support

πŸ“ž Support

πŸ†˜ Need Help?

  1. πŸ“– Check Documentation - Most common issues are covered here
  2. πŸ” Search Issues - Someone might have already reported it
  3. πŸ› Create Issue - Provide detailed information about the problem
  4. πŸ’¬ Contact Author - Reach out to Ashlynn

πŸ”— Useful Links


πŸ“„ License

This project is licensed under the MIT License.

MIT License

Copyright (c) 2025 TeraBox Web - Ashlynn

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

πŸ™ Acknowledgments

  • TeraBox - For providing the file sharing service
  • React Team - For the amazing React framework
  • Tailwind CSS - For the utility-first CSS framework
  • Netlify - For hosting and serverless functions
  • Lucide - For the beautiful icon set

⭐ Star this repository if you found it helpful! ⭐

Made with ❀️ by Ashlynn

🌐 Live Demo β€’ πŸ™ GitHub β€’ πŸ“ž Contact

About

TeraBox Video Downloder Web

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 73.5%
  • JavaScript 20.6%
  • CSS 4.4%
  • HTML 1.5%