Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
The Explorer is a file explorer. You should be very aware of the fact that it IS a typical file explorer. Most cases of data loss have been the result of people mistaking it for a cleaning tool and thus assumed that everything it showed was safe to delete. That's not the case, these are all the files on your device.
The Explorer offers the usual operations such as copying, moving, renaming files etc. In contrast to some other file explorer apps it does not display the device in a "simplified" view, such that it shows a button for "System", "SDCard" and "External SDCard". It shows the file system exactly how it exists on the device.
You navigate down the directory tree by tapping folders to enter. Going backwards is done by pressing the devices backbutton or tapping directories on the path in the browser bar at the top.
The explorer displays two file sizes. Format:
allocated size (file size)
Allocated size is the space a file occupies on the in the filesystem. A filesystem stores data in blocks with fixed size. If the file size is 1Byte, but the blocksize of the filesystem is 4096Byte, then storing the file means that the allocated size is 4096Byte. Think of it like sorting items into same sized boxes, but each box may only contain one item.
Usually the allocated size is within a few KB (the blocksize) of the file size. Depending on the file system there can be exception such as sparse files.
In the following screenshot, the file
0.91KB in size but occupies
8KB of filesystem space.
If you are certain that the size is incorrect and you have undstood the difference between
file size and
allocated size, then your ROM may be affected by a kernel bug, see here.
Androids basic file system access is based on the linux permission attributes
EXECUTE(x) for the permission groups
OTHER. SD Maid displays these permissions in that order, e.g.
rwxrwxrwx meaning read, write and execute permission for owner, group and other.
This holds true for most of an Android devices storage except for public internal and external storage (depending on device ROMs and Android versions). These locations may be accessed through a "fuse-daemon" which wraps the storage itself and lets the system enforce additional access rules. Due to this an item or location could have the permission
rwxrwxrwx but still not be accessible (read or writable) for SD Maid and apps. SD Maid's explorer displays this by changing the color of the permission label. An orange color indicates that SD Maid can read, but not write to that location, while a red color indicates that SD Maid can neither read nor write to that location.
If you look at a line in the Explorer you will see multiple icons. On the left side there is an icon that displays the file type such as directory or file including a preview if possible (and you have SD Maid Pro).
The right side displays the result of SD Maids "ownership research". When browsing a folder, SD Maid will try to determine who the owner of an item is. A successful research will either result in the owners app icon being displayed or a ghost if the owning app is no longer installed. If the results are inconclusive a
? will be displayed.
If an app icon is shown then SD Maid knows who the owner is. Multiple icons may be shown if SD Maid knows multiple owners for this item.
? means that SD Maid doesn't know the owner of this item. If you know the owner, press the questionmark and help improve SD Maid.
The SystemCleaner icon is shown for files that match any SystemCleaner filter. Note SD Maid will test all filters, even those that are not enabled. In this example the folder
calimoto matches the empty directory filter and also has an unknown owner.
A normal corpse will be marked by the CorpseFinder's icon in white. Running the CorpseFinder should show this item in the scan results. Note that Explorer checks all CorpseFinder filters, even those that are turned off.
The orange CorpseFinder icon signifies a corpse that is flagged as "keeper". It is considered a "desirable remanent". This is usually reserved for files such as photos that you may want to keep even without the camera app. To show these corpses among the CorpseFinder results you have to turn on explicitly enable "Show desirable remnants" in the settings.
Items that are flagged as "common" will display a teal CorpseFinder icon. Items are flagged as "common" if they name is too short or too common to make a safe decision regarding ownership. For safety reasons, SD Maid currently does not support automated deletion of these items. In this example the folders name
backups is used too often my too many apps, it would be very prone to false positive results.
Most operations are item related, that means you have to long press an item to select one (or multiple) such that the context menu becomes visible and then select an operation out of the context menu. Note that due to Android constisting of many different storage areas, not all operations success on every time.
A few extra operations are not shown by default and have to be enabled in the settings.
Note: SD Maid will remount a read-only partition if necessary for the operation to succeed.
Deletes the selected items...
New item creation
Creating new files or directories is currently the only operation that works without selecting an item first.
Copy / Move / Paste
Basic file operations that allow you to copy or move files. Select the files you want to copy/move, then choose an operation from the context menu, the selection will close and you should see a new paste (clipboard) icon in the toolbar. Now you can move around in the directories and when you found your destination, paste the items into it.
Renames the select file or directory
Calculates the select items sizes. If multiple items are selected, each items size is calculated, then added.
Opens a new window to exclude the selected path from select tools. See Exclusions.
Allows you to change the owner, group and other file permissions. Note that this does usually not work on public storage or any storage that can be accessed without root as the system enforces specific permissions for these locations.
Attempts to share the selected file through another app, e.g. mailing a picture. It is currently not supported to share files that the other application can not access itself.
Helps you create a user filter for the SystemCleaner. It will open the user filter creation screen and prefill a few fields such that the created filter would match the files you selected.
Save directory structure
Will create a text file on your primary storage (e.g. root of your sdcard) that contains the file/directory structure (recursively) of the selected items. A better way than screenshots to share specific file setups with other users (or me :p).
Tries to extract an ZIP based archive (
.apk etc) into a new directory in the current path. The directory will be the filename appened with
-(2) and so forth). Extraction is currently only possible on public storage.
On the right screen side sliding out side drawer. It contains a bookmarks manager that provides a set of shortcuts to interesting default locations. You can add new entries by entering a folder, then opening the bookmarks drawer and pressing the plus button to the right of the path in the browser bar. Bookmarks can be removed by long pressing them.
Try to start in the same directy as you were previously in, after closing+reopening SD Maid.
Whether SD Maid should try to determine owner ship of files and directors. This is responsible for the little app icons in each row. This setting also influences whether SD Maid displays a small sdcard symbol in each row that is a mount-point on the device.
Whether SD Maid should test if this file/directory fits any existing SystemCleaner filter. This includes both default and user-made filters. If it fits, the SystemCleaner icon will be displayed.
Whether SD Maid should test if this file/directory fits any existing AppCleaner filter. This includes both default and user-made filters. If it fits, the AppCleaner icon will be displayed.
How list entries should be sorted, by default it's sorted like in Windows. By name, but directories first.
Adds an "app-like" shortcut to your launcher that directly takes you to the Explorer and loads the current directory.
There are a few extra file/directory context actions that are not shown by default, you can enable them here.