treeger user guide
A concise guide to storage access, Home, Spaces, browsing, search, file operations, Trash, and settings in treeger.
This guide describes the main workflows in the current treeger application without documenting every control or Android system dialog.
Grant storage access
treeger needs storage access to work as a general file manager. On Android 11 and newer, the app asks you to allow all-files access in Android settings. On Android 10, first allow the platform’s photos-and-media permission. Then use the system folder picker to select the top-level Device Storage location and confirm access. If Device Storage is not listed, open the picker’s menu and enable Show internal storage first. Android keeps this folder grant across app and device restarts until you revoke it or uninstall treeger.
The app can also read compatible Android document-provider locations, although not every local file operation or Trash workflow is available through every provider.
Use Home
Home brings together four kinds of entry point:
- Spaces
-
Open Explorer for hierarchical browsing, Gallery for images and videos, or Documents for document-oriented browsing.
- Recently Used
-
Reopen files you opened recently, or clear the locally stored history.
- Recently Added
-
Open the newest files added to device storage, including downloads, camera files, screenshots, exports, and newly created documents indexed by Android.
- Pins
-
Add frequently used folders, drag them into your preferred order, open them directly, or remove them from Home.
- Storage
-
Enter the device’s device storage.
Recently Used and Recently Added appear as stacked card decks. Tap the front card to open it, or swipe it left to move it behind the other cards and reveal the next file. The deck cycles rather than ending after the last card.
Pins use their folders' actual names. Opening a nested pin retains the complete path in the breadcrumbs, and both default and user-added pins are available while choosing a copy or move destination. Pins follow folders renamed or moved with treeger; the not-found warning is reserved for folders that were deleted or became unavailable.
The application navigation drawer provides direct access to Home, Trash, Settings, and About. Switching among them preserves your place in the Home/Space browsing flow. Top-level screens use the menu button. Inside a Space, drag right from within the screen to open the application drawer; swiping from the extreme left edge or using Back continues to return through folders and Home.
Browse and view files
Tap a folder to enter it and use the breadcrumbs to move back through its parents. Tap a file to open it in a supported viewer; media can open in treeger’s viewing flow, while other formats may be handed to a compatible installed app.
The Browse options sheet lets you switch Space, choose List or Grid, and sort by name, modification date, size, or type. Section headings outside Home include an up/down chevron. Tap a heading to hide or show that group; when several groups are present, use the top-bar action to collapse or expand all of them together.
Content Spaces use Android’s MediaStore index by default for included folders in local shared storage. This keeps Gallery, Documents, and future custom Content Spaces fast without maintaining a second treeger index. Provider-backed or unsupported roots use recursive discovery instead. Explorer remains available when you need exhaustive folder-by-folder access to files omitted from Android’s index. Android-indexed changes update the visible Content Space automatically. A local Explorer folder also updates its direct listing from the same change notification; provider-backed folders are refreshed when they are opened again. Folder-specific view choices are remembered. Image files can show thumbnails; folders and other files use stable fallback artwork.
Use Settings > Show hidden files when you want folder listings to include hidden items and dotfiles.
Find files
Search starts in the location you are browsing. In Explorer, you can search only the current folder, include subfolders, or search device storage. Filters can narrow results by file type, modification period, or size, and Documents can expose more specific document-format filters.
Search is performed on demand rather than through a permanent content index. A large recursive search can therefore take time, and an unavailable folder may be reported without discarding results already found elsewhere.
Manage files and folders
Long-press an item to begin selection, then select more visible items as needed. Available actions depend on the selection and storage location, and include:
-
Select all, share selected files, and view properties when one item is selected.
-
Create a folder and rename an item.
-
Copy or move files and folders, browse alphabetically sorted Pins and folders for a destination, create a destination folder when needed, review the carried selection, and resolve name conflicts explicitly.
-
In Explorer List or Grid, press and drag an already-selected item onto a visible folder or ancestor breadcrumb. Hold over either target to enter it, release at the destination, then choose Copy here or Move here. Cancel restores the original selection; after success, the destination items remain selected so they can be dragged again immediately.
-
Cancel an active transfer; longer transfers continue through Android’s background-work mechanism and show an ongoing notification.
-
Delete supported local items by moving them to treeger’s Trash.
In List view, swipe a supported file or folder from right to left to open the same Delete confirmation. The gesture is unavailable while selecting items or carrying an active copy or move operation. After a successful file operation, the current Space stays near the same scroll position while its contents refresh.
treeger does not silently overwrite an existing destination. When a conflict occurs, choose the offered resolution before the operation continues.
Recover or permanently delete items
Deleting supported local files or folders moves them into treeger’s app-managed Trash and offers an immediate Undo action. Open Trash from the navigation drawer to restore items, permanently delete selected items, or empty Trash. Swiping a Trash row from right to left opens the Delete forever confirmation; it never bypasses that warning.
If the original destination already contains the same name, restoration asks whether to keep both, replace the destination, or cancel. Trash is not a shared Android trash service, and locations exposed through document providers may not support it.
In Settings, choose whether trashed items expire after 7, 30, or 90 days, or are retained indefinitely. Shortening the retention period requires confirmation before already-expired items are permanently deleted.
Adjust appearance and behavior
Settings currently provides:
-
Canopy and Bloom visual identities. Android controls whether the app uses its light or dark colors.
-
A switch for hidden files.
-
Trash retention.
For information about storage access and locally retained preferences, see Privacy policy.