Atlas

Atlas is a fast, lightweight Material Design 3 file manager built with Qt 6 and QML.

Dependencies

Build Dependencies (Required)

• C++20 compiler: GCC 11+ or Clang 14+
• CMake 3.19+
• Ninja build system
• pkg-config
• Qt 6.5+ development packages:
  • Qt6Core
  • Qt6Gui
  • Qt6Qml
  • Qt6Quick
  • Qt6QuickControls2
  • Qt6QuickEffects
  • Qt6Concurrent
  • Qt6Svg
  • Qt6Multimedia
  • Qt6Network
  • Qt6DBus

Runtime Dependencies (Required)

• Qt 6 runtime libraries:
  • qt6-declarative / qt6-qml
  • qt6-quickcontrols2
  • qt6-quickeffects
  • qt6-svg
  • qt6-multimedia
  • qt6-network
  • qt6-dbus

Optional Dependencies

• udisks2: external drive and partition detection, mounting, and unmounting
• gvfs and gvfs-backends: remote network filesystem mounting for SFTP, SMB, FTP, NFS, WebDAV
• gio: command-line URI mounting and volume management
• xdg-utils: default application launching via xdg-open
• git: inline repository status, branch tracking, and Git modal operations
• ffmpeg: media tools for video and audio (trim/clip, format conversion, rotate/flip)
• imagemagick: image conversion in the Media Tools menu (supports any readable format, including SVG, PDF, HEIC)
• exiv2 (development package at build time): EXIF metadata display for photos in the preview panel and properties dialog; builds without it when absent
• caelestia-cli: dynamic color palette and accent syncing with Caelestia
• papirus-icon-theme and papirus-folders: dynamic folder color and system icon theme integration
• Archive tools: p7zip, tar, gzip, bzip2, xz, zip, unzip for archive extraction and compression

Build Instructions

# Configure
cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release

# Build
cmake --build build

# Run file manager locally
./build/bin/atlas

Installation

# Install system-wide: installs atlas and its desktop entry
sudo cmake --install build

# Or install to a custom prefix
cmake --install build --prefix ~/.local

Uninstallation

# Remove all installed files recorded in the build manifest
sudo xargs rm -fv < build/install_manifest.txt

Documentation

Documentation for working on Atlas is in docs/.

Credits and Licensing

This project is licensed under the GNU General Public License v3.0 (GPLv3).

Atlas incorporates design tokens, QML components, animations, and styling derived from Caelestia Shell. Heavy credit and gratitude go to the authors and contributors of Caelestia Shell for their work under the GPLv3 license.