ShareJadPi

Appearance

📤 Uploading Files ​

Learn How to Share Files

Master the art of uploading files to ShareJadPi - it's easier than you think!

🎯 The Basics ​

Uploading files to ShareJadPi is incredibly simple. There are two ways:

Method 1: Drag & Drop 🖱️ ​

Simply drag files from your file explorer directly onto the ShareJadPi window.

Method 2: Click to Browse 📁 ​

Click the upload area to open a file picker dialog.

Both methods work perfectly - use whichever feels more natural!

📖 Step-by-Step Tutorial ​

Step 1: Open ShareJadPi ​

Make sure ShareJadPi is running and open the web interface in your browser:

http://localhost:5000

Or from another device:

http://192.168.1.100:5000

You should see the main interface:

┌─────────────────────────────────────┐
│  📤 ShareJadPi v4.5.4-dev          │
├─────────────────────────────────────┤
│                                     │
│      📁  Drop files here           │
│         or click to browse          │
│                                     │
├─────────────────────────────────────┤
│  📂 Uploaded Files                  │
│  (empty)                            │
└─────────────────────────────────────┘

Step 2: Select Your Files ​

Using Drag & Drop:

  1. Open your file explorer (Finder on Mac, File Explorer on Windows)
  2. Navigate to the files you want to share
  3. Click and hold on the file(s)
  4. Drag them over the ShareJadPi browser window
  5. Drop them into the upload area

Using Click to Browse:

  1. Click anywhere in the upload area
  2. A file picker dialog opens
  3. Navigate to your files
  4. Select one or multiple files
  5. Click "Open"
💡 Pro Tip: Hold Ctrl (Windows/Linux) or Cmd (Mac) to select multiple files at once!

Step 3: Watch the Upload ​

Once you drop or select files, uploading begins automatically:

You'll see:

  • ⏳ Progress bar showing upload progress
  • 📊 Percentage (0% → 100%)
  • ✨ Shimmer animation while uploading
  • ✅ Success message when complete

Step 4: Verify Upload ​

After upload completes:

  • The progress bar disappears
  • You see a success notification
  • Your file appears in the "Uploaded Files" section
  • The file is now accessible to all devices on the network!

🎨 What Happens During Upload? ​

Behind the Scenes ​

  1. Validation: File size checked (max 500MB)
  2. Encoding: File wrapped in FormData
  3. Upload: Sent via HTTP POST to /upload
  4. Processing: Server receives and validates
  5. Storage: File saved to ~/ShareJadPi-Dev/uploads/
  6. Response: Success message sent back
  7. UI Update: File appears in list

📝 Upload Rules & Limits ​

File Size Limit ​

Maximum file size: 500 MB per file

Why? This is a development server designed for typical file sharing scenarios. For larger files, consider:

  • Splitting into smaller parts
  • Using external storage
  • Waiting for production version with configurable limits

File Types ​

Supported: ALL file types! ✅

ShareJadPi accepts any file extension:

  • 📄 Documents (.pdf, .docx, .xlsx, etc.)
  • 🖼️ Images (.jpg, .png, .svg, etc.)
  • 🎬 Videos (.mp4, .mov, .avi, etc.)
  • 🎵 Audio (.mp3, .wav, .flac, etc.)
  • 📦 Archives (.zip, .tar, .7z, etc.)
  • 💻 Code files (.py, .js, .html, etc.)
  • ...literally anything!

Filename Handling ​

Duplicate names? ShareJadPi automatically handles them:

python
# Original upload
document.pdf → document.pdf

# If you upload another file with same name
document.pdf → document (1).pdf

# And another
document.pdf → document (2).pdf
⚠️ Note: Filenames are sanitized for security. Special characters may be removed or replaced.

🚀 Advanced Upload Techniques ​

Multiple Files at Once ​

You can upload multiple files simultaneously:

Drag & Drop:

  1. Select multiple files in your file explorer
  2. Drag them all together
  3. Drop onto ShareJadPi

Click to Browse:

  1. Click the upload area
  2. In the file picker, select multiple files:
    • Hold Ctrl/Cmd and click multiple files
    • Or hold Shift and click first and last file to select range
  3. Click "Open"

Result: All files upload in parallel! 🎉

Uploading from Different Devices ​

From Your Phone:

  1. Open ShareJadPi URL in mobile browser
  2. Tap the upload area
  3. Choose "Photo Library" or "Browse"
  4. Select photos/files
  5. Tap "Done"

From Your Tablet:

  1. Same as phone - works in any browser
  2. iPads can drag & drop like desktop!

From Another Computer:

  1. Open ShareJadPi URL
  2. Use drag & drop or browse
  3. Same experience as the host computer

🎯 Real-World Upload Scenarios ​

Scenario 1: Photo Transfer ​

Goal: Transfer 50 vacation photos from phone to computer

  1. Run ShareJadPi on computer
  2. Open ShareJadPi URL on phone
  3. Tap upload area → Photo Library
  4. Select all 50 photos
  5. Tap "Choose"
  6. Wait for upload (usually 30-60 seconds)
  7. Photos now accessible on computer!

Time: 1-2 minutes vs 10+ minutes with cloud upload/download

Scenario 2: Document Sharing ​

Goal: Share a presentation with team in meeting room

  1. You run ShareJadPi on laptop
  2. Upload your presentation.pptx
  3. Share the URL with team: http://192.168.1.100:5000
  4. Everyone opens URL on their devices
  5. Everyone downloads the presentation

Benefit: No email attachments, no USB drives, instant access for everyone

Scenario 3: Large Video File ​

Goal: Move a 400MB video from camera to computer for editing

  1. Connect camera SD card to any device with browser
  2. Open ShareJadPi URL
  3. Upload the video file
  4. From editing computer, download the video
  5. Start editing immediately

Speed: Full LAN speed (often 100+ MB/s) = 4 seconds vs 20+ minutes uploading to cloud then downloading

🐛 Troubleshooting Uploads ​

Problem: Upload Fails ​

Possible causes:

  • File too large (> 500MB)
  • Disk space full on server
  • Network disconnection

Solutions:

  1. Check file size - compress if needed
  2. Check disk space: df -h (Mac/Linux) or File Explorer (Windows)
  3. Ensure stable network connection

Problem: Upload Stucks at 99% ​

Solution:

This is normal for large files - the server is finishing writing to disk. Wait a few more seconds.

Problem: File Uploaded But Not Showing ​

Solution:

  1. Refresh the page (F5)
  2. Check the uploads folder manually: ~/ShareJadPi-Dev/uploads/
  3. Restart ShareJadPi if issue persists

Problem: "No file provided" Error ​

Solution:

The file wasn't properly selected. Try again and ensure:

  • You actually selected a file
  • The file still exists at the location
  • You have read permissions for the file

⚡ Performance Tips ​

For Fastest Uploads ​

  1. Use Wired Connection

    • Ethernet is faster than Wi-Fi
    • Expected: 100-1000 MB/s wired vs 10-50 MB/s Wi-Fi

  2. Close Unnecessary Apps

    • Free up network bandwidth
    • Close downloads, streaming, etc.

  3. Upload One Large File at a Time

    • Better than many small files simultaneously
    • Reduces overhead

  4. Use Same Router

    • All devices connected to same Wi-Fi router
    • Avoid guest networks or range extenders

  5. Compress When Possible

    • ZIP large folders before uploading
    • Smaller size = faster transfer

🎓 Next Steps ​

Now that you can upload files, learn how to download them:

Continue to Downloading Files →

Or explore related topics:

Built with ❤️ by Het Charusat

ShareJadPi - Modern File Sharing Application