Wanderer - FreeWorld File Manager

Location: wanderer/wanderer.c
Type: C Executable
Purpose: File and folder operations manager

Overview

Wanderer is the FreeWorld file manager, similar to Windows Explorer or Linux Nautilus. It provides tools for controlling all file and folder operations, similar to how classic DOS and Linux handle file management.

Status: ✅ Complete - Full file management with file type associations, icon support, and graphical interface

Key Features

  • File Type Associations: Automatic icon and application mapping for 100+ file types
  • Icon Display: Real icon files with emoji fallbacks
  • Filesystem Type Display: Shows filesystem type with OS association (e.g., "NTFS (Windows)", "ext4 (Linux)")
  • Open With: Double-click files to open with default applications
  • File Operations: Create, delete, move, copy, rename files and folders
  • Navigation: Back, forward, up, and path navigation
  • Context Menus: Right-click context menus for files and folders
  • Trash Integration: Deleted files moved to trash system

Functions

list_directory

Lists directory contents with file information:

void list_directory(const char* path);

Parameters:

  • path: Directory path to list

Description: Displays directory listing with name, type, and size columns.

main

Main entry point:

int main(int argc, char** argv);

Parameters:

  • argc: Argument count
  • argv: Argument array (first argument is optional directory path)

File Type Associations

Wanderer uses the File Type Associations system to:

  • Display appropriate icons for each file type
  • Determine default applications for opening files
  • Show file type descriptions
  • Map MIME types to file extensions

See File Type Associations for complete details on supported file types.

Icon System

Wanderer uses the Icon System to display icons:

  • Real icon files from usr/share/icons/64x64/
  • Emoji fallbacks when icon files are not found
  • Automatic icon switching (e.g., trash empty vs. full)
  • HTTP icon serving for web-based GUI

See Icon System for complete details on icon management.

Filesystem Type Display

Wanderer displays filesystem type information for each folder and drive, helping users identify which operating system a filesystem belongs to:

  • Automatic Detection: Filesystem type is automatically detected by the kernel
  • OS Association: Shows OS type alongside filesystem type (e.g., "NTFS (Windows)", "ext4 (Linux)")
  • Supported Types: FAT32, ext2, ext3, ext4, NTFS, exFAT
  • Display Format: "[Filesystem Type] ([OS Type])"

This feature is powered by the native filesystem support in the kernel. See File System (Kernel) for details on filesystem drivers.

Filesystem Type: NTFS (Windows)
Filesystem Type: ext4 (Linux)
Filesystem Type: FAT32 (Windows/Linux)

Directory Listing Format

Wanderer displays directory listings with icons and file information:

Icon  Name                           Size           Modified
------------------------------------------------------------
📄   file1.txt                     1024 bytes     2024-01-01 12:00:00
📁   folder1                        4096 bytes     2024-01-01 12:00:00

In the graphical interface, icons are displayed as images from the icon system.

Variables

Variable Type Scope Description
entry struct dirent* local Directory entry pointer
file_stat struct stat local File statistics structure
full_path char[1024] local Full file path buffer
start_path const char* local (main) Starting directory path

Cross-Platform Support

Wanderer supports both Windows and Linux:

#ifdef _WIN32
#include 
#include 
#else
#include 
#endif

File Operations

Wanderer provides comprehensive file operations through the FileManager class:

  • Create: Create files and folders
  • Delete: Delete files and folders (moves to trash)
  • Move: Move files and folders
  • Copy: Copy files and folders
  • Rename: Rename files and folders
  • Properties: View file properties and metadata
  • Clipboard: Cut, copy, and paste operations
  • Search: Search for files and folders

Navigation

Wanderer provides full navigation capabilities:

  • Back: Navigate to previous directory
  • Forward: Navigate to next directory
  • Up: Navigate to parent directory
  • Path Navigation: Navigate to specific path
  • History: Maintains navigation history

Context Menus

Wanderer provides context menus for files, folders, and the desktop:

  • File Context Menu: Open, Open With, Cut, Copy, Delete, Rename, Properties
  • Folder Context Menu: Open, Open With, Cut, Copy, Delete, Rename, Properties
  • Desktop Context Menu: New Folder, New File, Paste, View, Sort By, Refresh, Properties

Related Documentation

Usage

wanderer.exe [directory]

If no directory is specified, lists the current directory.