Atlas

KO | EN

gitlite — search

#kubernetes #dotnet #security #nodejs #docker #mysql #ios #graphql #computer-vision #tailwindcss

(★ 17)

Native Caelestia File Manager

파일 탐색기

ZIP 다운로드

- - bug_report.yml
  - feature_request.yml
- - build.yml
  - release.yml
- banner.png
- pull_request_template.md
- - GoogleSansFlex.ttf
  - MaterialSymbolsRounded.ttf
- - LICENSE
- atlas.desktop
- atlas.png
- atlas.svg
- icons.txt
- material_icons.txt
- - Anim.qml
  - CachingIconImage.qml
  - CAnim.qml
  - Mask.qml
  - MaterialIcon.qml
  - StateLayer.qml
  - StyledRect.qml
  - StyledScrollBar.qml
  - StyledText.qml
  - StyledToolTip.qml
- - FileNameHelper.js
- main.qml
- - colours.cpp
  - colours.hpp
  - font.cpp
  - font.hpp
  - fontbuilder.cpp
  - fontbuilder.hpp
  - tokens.cpp
  - tokens.hpp
- - tabmanager.cpp
  - tabmanager.hpp
- - appcontroller.cpp
  - appcontroller.hpp
  - appintegration.cpp
  - appintegration.hpp
  - catboxuploader.cpp
  - catboxuploader.hpp
  - circularindicatormanager.cpp
  - circularindicatormanager.hpp
  - drivemanager.cpp
  - drivemanager.hpp
  - exifreader.cpp
  - exifreader.hpp
  - filemetadata.cpp
  - filemetadata.hpp
  - fileoperations.cpp
  - fileoperations.hpp
  - fileutils.cpp
  - fileutils.hpp
  - gitmanager.cpp
  - gitmanager.hpp
  - iconcatalog.cpp
  - iconcatalog.hpp
  - iconprovider.cpp
  - iconprovider.hpp
  - mediatools.cpp
  - mediatools.hpp
  - mimeservice.cpp
  - mimeservice.hpp
  - networkmanager.cpp
  - networkmanager.hpp
  - papiruswatcher.cpp
  - papiruswatcher.hpp
  - placesmodel.cpp
  - placesmodel.hpp
  - recentfiles.cpp
  - recentfiles.hpp
  - runnergame.cpp
  - runnergame.hpp
  - thumbnailprovider.cpp
  - thumbnailprovider.hpp
  - trashlocations.cpp
  - trashlocations.hpp
- - filesystemmodel.cpp
  - filesystemmodel.hpp
- main.cpp
.gitignore
CMakeLists.txt
LICENSE
README.md
THIRD_PARTY_NOTICES.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Atlas</h1>

Atlas is a fast, lightweight Material Design 3 file manager and file picker 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

```bash
cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release

# Build
cmake --build build

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

# Run picker mode directly
./build/bin/atlas -p
```

## Installation

```bash
# 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

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

## XDG Desktop File Picker

For desktop-wide portal integration (system file chooser dialogs in browsers, editors, and other applications), use [Wormhole](https://github.com/AstraSuite/Wormhole), which can drive Atlas in picker mode.

### Window Rules on Wayland Compositors

To ensure the picker opens centered as a floating modal, add a window rule for the picker title.

#### Hyprland

In your `hyprland.conf`:

```ini
windowrulev2 = float, title:^(.*Atlas File Picker.*)$
windowrulev2 = center, title:^(.*Atlas File Picker.*)$
windowrulev2 = size 1000 620, title:^(.*Atlas File Picker.*)$
windowrulev2 = focusonactivate, title:^(.*Atlas File Picker.*)$
```

#### Caelestia in ~/.config/caelestia/hypr-user.lua

```lua
local rules = {
    {
        pattern = ".*Atlas File Picker.*",
        type = "title",
        float = true,
        center = true,
        size = "1000 620",
        focus = true
    }
}
```

### Direct CLI Picker Mode

Atlas can also be invoked directly in picker mode by scripts or external tools:

```bash
# Open file picker
atlas -p -t "Select File" -d ~/Documents

# Save file picker
atlas -p -s -t "Save As" -d ~/Downloads

# Directory only picker
atlas -p --directory-only -t "Select Directory"

# Filter by extensions
atlas -p -f "png,jpg,webp" -t "Select Image"
```

## 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](https://github.com/caelestia-dots/shell). Heavy credit and gratitude go to the authors and contributors of Caelestia Shell for their work under the GPLv3 license.

Atlas

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Atlas

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README