recloudstream / recloudstream/cloudstream

Feature Request: Add "Scan / Import Existing Files" for Local Downloads

Open
#2,537 0 comments 3 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
Kotlin
Stars
10.7k
Forks
1.1k
Avg merge
1d 23h
Merged PRs (30d)
15

Description

Describe your suggested feature

Currently, Cloudstream only lists downloads that were created and registered by the app itself.

If video files are manually restored or copied into the selected download folder (via SAF / folder picker), they are not detected or indexed. The Downloads tab remains empty even though the files exist and are playable through other apps.

There is currently no way to rescan or rebuild the internal download index from existing files in the selected directory.

This causes unnecessary re-downloading when:

  • An SD card is repaired or reformatted
  • Files are restored from backup
  • Users migrate to a new device
  • Media is copied from PC to phone
Other details

Suggested Improvement:

Add one of the following:

  • A "Scan Folder" button
  • An "Import Existing Files" option
  • Automatic re-indexing of the selected download directory

Expected behavior:

  • Scan the selected SAF folder
  • Detect valid video files (.mp4, .mkv, etc.)
  • Register them in the local downloads list
  • Allow playback using the internal player

Benefits:

  • Prevent unnecessary re-downloads
  • Improve SD card resilience
  • Support backup and restore workflows
  • Improve device migration experience
  • Better support for portable storage users
Acknowledgements
  • My suggestion is NOT about adding a new provider
  • I have searched the existing issues and this is a new ticket, NOT a duplicate or related to another open issue.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by tracing how the Downloads tab reads the local download index and how the selected SAF folder is accessed. Define the scan/import flow around those entry points, including supported video files and playback registration; done means restored files appear in Downloads and play in the internal player without re-downloading.

Written by the indexing model from the issue text.

Assessment

Tech stack
android, kotlin
Domain
mobile
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.