Skip to content

DaLaw2/Constellation

Repository files navigation

Constellation

Organize your universe of files.

Constellation Main View

Constellation is a Windows desktop application that breaks free from the limitations of traditional folder hierarchies. Using a flexible tag system, you can classify your files across multiple dimensions simultaneously—without being forced into a single organizational structure.


💡 The Problem with Folders

Traditional folder structures force you to choose a single classification dimension:

Option A: By Language           Option B: By Author
├─ Japanese/                    ├─ Author A/
├─ English/                     ├─ Author B/
└─ Chinese/                     └─ Author C/
   └─ Some Work/                   └─ Some Work/
      ❌ Can't find by author         ❌ Can't find by language

You can't answer questions like:

  • "Show me all Japanese works by Author A that are full-color"
  • "Find all original works in English"
  • "List everything by Author B that's complete"

✨ The Constellation Solution

Multi-Dimensional Tagging

Tag any folder or file with multiple attributes:

  • Language: Japanese, English, Chinese
  • Author: Creator names
  • Work: Series or project names
  • Attributes: Full-color, Original, Complete, etc.

Then search using Boolean logic (AND/OR) to find exactly what you need:

  • Japanese AND Author A AND Full-Color
  • Author B AND (Original OR Fan Work)

Non-Invasive Design

  • No filename modifications
  • No extra files in your folders
  • All tags stored in a separate SQLite database
  • Your original file structure stays untouched

📸 Screenshots

Tag Management with Color Groups Boolean Search & Filtering
Create tag groups with custom colors for visual organization Combine multiple tags to find exactly what you need

🎯 Key Features

🏷️ Flexible Tag System

  • Tag Groups: Organize tags into categories (Language, Author, Status, etc.)
  • Color Coding: Assign colors to tag groups for quick visual identification
  • Tag Templates: Save frequently used tag combinations for one-click application
  • Auto-Complete: Suggestions while typing to avoid duplicates

🔍 Powerful Search

  • Boolean Queries: Combine tags with AND/OR logic
  • Real-Time Filtering: Click tags in the sidebar to instantly filter results
  • Fuzzy Filename Search: Quick partial matching for file names

🗂️ Integrated File Browser

  • Dual-Panel Interface:
    • Left: Toggle between file tree or tag management
    • Right: File list with tag information
  • Multiple View Modes:
    • Detail view with sortable tag columns
    • Large icon view with tags below filenames
  • Smooth Performance: Virtual scrolling handles thousands of files effortlessly

🧘 Zen Mode

  • Collapse the file browser to focus purely on tag organization
  • Perfect for organizing and refining your tag system

🆚 Why Not Use...?

Solution Limitation
TagSpaces Modifies filenames or creates sidecar files that clutter your folders
Eagle Forces you to import files, breaking your original folder structure
Obsidian/Notion Can only create references, can't operate on actual files
Directory Opus Expensive, complex, replaces your entire file manager
macOS Finder Tags macOS only, tags frequently lost when moving files

Constellation keeps your folders clean, works directly with files, and is built specifically for Windows.


🛠️ Tech Stack

  • Core: Rust + Tauri 2.0
  • Frontend: Vue 3 + TypeScript + Pinia
  • Database: SQLite (via rusqlite)
  • Platform: Windows 10+ (optimized for Windows-specific features)

🚀 Getting Started

For Users

Download the latest release from the Releases page.

System Requirements:

  • Windows 10 or later
  • 150MB available disk space

For Developers

Prerequisites:

Installation:

# 1. Clone the repository
git clone https://github.com/yourusername/constellation.git
cd constellation

# 2. Install dependencies
npm install

# 3. Run in development mode
cargo tauri dev

Building:

cargo tauri build

The executable will be in src-tauri/target/release/.


📝 Known Limitations (v1.0.0)

  • Thumbnail generation not yet implemented (image/video/folder previews)
  • Automatic path tracking not yet implemented (manual update needed if folders are renamed outside the app)
  • Windows only (utilizes Windows-specific APIs)

📄 License

GNU GPLv3


👏 Acknowledgements

About

Organize your universe of files.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •