File Manager Guide - softerfish/fyuhls GitHub Wiki

File Manager Guide

The file manager is the main day-to-day workspace for normal users. It is where they upload, organize, search, share, move, trash, and restore files and folders.

For admins, it is also one of the most important user-facing surfaces to understand, because many support questions start there.

The current account area is more unified than older releases. The main file manager shell now closely matches the surrounding account pages such as:

  • Settings
  • Rewards
  • Affiliate
  • Notifications

What the file manager is for

Use the file manager to:

  • upload files and folders
  • create folders
  • move or copy items
  • search and filter content
  • switch between list and grid views
  • send items to trash or restore them
  • review storage usage and package bandwidth indicators

Main areas of the file manager

Sidebar

The sidebar is the navigation layer. Depending on configuration and account state, it can include:

  • all files
  • recent
  • shared
  • trash
  • rewards and affiliate areas
  • account and settings shortcuts
  • a logged-in View Plans upgrade path for free users when paid packages exist

It can also show:

  • package information
  • daily download allowance
  • storage quota progress or warning state

If paid packages are configured, View Plans now takes the user to a dedicated logged-in plans page instead of dumping them into the first paid package by guesswork.

Toolbar

The toolbar gives fast control over the current view, including:

  • search
  • select-all shortcuts
  • file-only or folder-only selection helpers
  • grid/list toggle
  • up-one-level navigation when inside folders

Upload area

The drop zone is the main upload entry point. Users can drag and drop files, browse from disk, and sometimes use remote URL upload.

Filter bar

The filter bar narrows large libraries by:

  • item type
  • visibility
  • status
  • extension
  • size
  • date
  • sort order
  • folders-first preference

File grid or list

This is the actual content view. Items can appear in grid view for visual scanning or list view for denser reading.

Grid view vs list view

Grid view

Grid view is best when:

  • users want a more visual layout
  • thumbnails or icons matter
  • the library is not too dense

List view

List view is best when:

  • users want denser scanning
  • filenames are long
  • users are comparing metadata more than visuals

If one layout feels wrong, make sure the user knows the toggle is there before treating it as a deeper bug.

Upload behavior

Fyuhls can support:

  • normal browser uploads
  • multipart direct-to-storage uploads
  • remote URL imports

What the user actually experiences depends on:

  • package limits
  • upload settings
  • configured storage provider
  • browser and network behavior

If uploads stall or error:

  • check package limits
  • check storage health
  • check CORS for object storage
  • check System Status and background jobs

If the user is on Local Storage, remember that the likely failure domain is different from object storage:

  • local permissions
  • route availability
  • request size limits
  • multipart temp staging

Searching and filtering

Important filters:

  • Search for one file or folder by name
  • Type for mixed folders
  • Visibility for public vs private review
  • Status for active vs processing items
  • Sort for newest-first and largest-first review

Saved filters help users who repeatedly rebuild the same view.

Folder operations

Users can typically:

  • create folders
  • open folders
  • move files into folders
  • move folders into other folders
  • rename folders
  • send folders to trash

If a folder does not appear where expected, first determine whether the user moved it, copied into another location, sent it to trash, or is looking at a filtered view.

Trash behavior

Trash is a soft-delete layer, not immediate destruction.

That means:

  • items moved to trash should appear in the Trash view
  • items can usually be restored from trash
  • permanent delete is separate and more destructive

If a user says something disappeared, check Trash before assuming it is gone.

Restore behavior

Items restored from trash return to active state. Depending on workflow, they may need to be moved again afterward if the user expected a different destination.

Move and copy

The move dialog helps users choose a destination safely. Common destinations include:

  • root
  • current folder
  • parent folder
  • recent destinations

Copy is for duplication. Move is for organization.

Sharing and visibility

Depending on site rules and package permissions, users may be able to:

  • copy share links
  • save a public file into their own account from the download page without re-uploading it
  • switch between public and private
  • use share-field formats from the share/download UI

The public Link Checker can also matter here now, because users may validate batches of file links and optionally copy eligible public files into their own account when that feature is enabled by the admin.

If sharing does not behave as expected, check:

  • package entitlements
  • file visibility state
  • whether the item is still processing

Quota and usage indicators

The file manager can surface:

  • storage quota usage
  • daily download bandwidth remaining
  • near-capacity warning colors

If users report failed uploads or missing upload options, check package storage limits, site storage capacity, and whether the user is over quota.

Common support issues

"My file is gone"

Check:

  • current folder
  • search
  • filters
  • trash
  • whether it was copied rather than moved

"I cannot upload"

Check:

  • package limits
  • quota
  • storage-node health
  • object-storage CORS
  • multipart session health and cron

"I cannot restore from trash"

Check:

  • whether the item is really in Trash
  • whether the action is restore vs move
  • whether the view is filtered in a way that hides the item afterward

"The file manager is slow"

Check:

  • very large folders
  • browser or device constraints
  • current filters and sort order
  • storage or server health

Good habits for operators

  • learn the file manager well before troubleshooting user upload complaints
  • treat Trash as the first stop for missing-file reports
  • teach users search and filters before escalating navigation complaints
  • separate file-manager UI issues from storage, package, or cron issues

Short version

The file manager is the user workspace. If you understand search, filters, trash, move/copy behavior, upload state, and quota warnings, you can solve a large percentage of user-facing support questions quickly.

⚠️ **GitHub.com Fallback** ⚠️