Loom v1.3.0 Beta

Loom v1.3.0 Beta

Major update with integrated live-server for web development workflow.

Installation

Debian/Ubuntu:

wget https://github.com/dexter-xd/loom/releases/download/beta_1.3.0/loom_1.3.0_amd64.deb
sudo dpkg -i loom_1.3.0_amd64.deb
sudo apt-get install -f
loom

System Requirements:

• Linux (Debian/Ubuntu or compatible)
• x86_64 architecture
• Qt5, Lua, and KDE Framework dependencies (auto-installed)

What's New in v1.3.0

🚀 Integrated Live-Server (MAJOR NEW FEATURE)

• Built-in web development server: No need for external tools like live-server or python -m http.server
• Hot reload functionality: Automatic browser refresh when files change
• Real-time file watching: Monitors HTML, CSS, JS, and other web files for changes
• WebSocket-based updates: Fast, efficient communication between server and browser
• Configurable settings: Port, directory, log levels, and auto-browser opening

🛠️ Live-Server Integration

• Tools menu integration: Start/stop live-server directly from the editor
• Status bar indicators: Shows server status, port, and URL when running
• Browser auto-open: Automatically opens your default browser to the development URL
• Error handling: Clear error messages and status updates
• Process management: Proper server startup, shutdown, and cleanup

⚙️ Enhanced Configuration

• Live-server settings in config.lua:
  • port: Server port (default: 8080)
  • auto_open_browser: Auto-open browser on start
  • log_level: "quiet", "normal", or "verbose"
  • show_output_in_console: Display server logs
  • default_directory: Custom serving directory
  • executable_path: Custom live-server binary path

🎨 Professional Output Formatting

• Clean console output: ANSI escape sequences automatically removed
• Filtered logging: Mongoose debug messages hidden for cleaner output
• Formatted status messages: Professional server status in status bar
• Configurable verbosity: Choose your preferred log level

📦 Enhanced Packaging

• Live-server binary included: No external dependencies for web development
• Complete distribution: Everything needed for web development workflow
• System integration: Proper installation paths and permissions

Live-Server Usage

Quick Start

1. Open your web project directory: loom /path/to/web/project
2. Go to Tools → Start Live Server
3. Browser opens automatically to http://localhost:8080
4. Edit your HTML/CSS/JS files - browser refreshes automatically!

Configuration Example

-- config/config.lua
config = {
    live_server = {
        enabled = true,
        port = "3000",                    -- Custom port
        auto_open_browser = true,         -- Auto-open browser
        log_level = "normal",             -- "quiet", "normal", "verbose"
        show_output_in_console = true,    -- Show server logs
        default_directory = "",           -- Use current file's directory
        executable_path = ""              -- Use bundled live-server
    }
}

Supported File Types

The live-server watches and triggers reloads for:

• HTML files: .html, .htm
• CSS files: .css, .scss, .sass, .less
• JavaScript files: .js, .ts, .jsx, .tsx
• Images: .png, .jpg, .jpeg, .gif, .svg, .webp
• Other web assets: .json, .xml, .txt

Key Features

• Professional text editing powered by KDE's KTextEditor framework
• Advanced syntax highlighting with KSyntaxHighlighting for 300+ languages
• 21 unified themes with consistent UI and syntax highlighting
• File tree viewer with project navigation and F12 toggle
• Multi-tab interface with clean, distraction-free design
• Working keyboard shortcuts with proper KTextEditor integration
• Lua-based configuration with dynamic menu updates
• Plugin system with theme switching, auto-save, and code formatting
• 🆕 Integrated live-server for web development with hot reload

Built-in Plugins

Theme Switcher Plugin:

• Toggle between 21 themes with Ctrl+Shift+T
• Unified theming for UI and syntax highlighting
• Includes Gruvbox, Dracula, Nord, Atom One Dark, and more

AutoFormat Plugin:

• Format code with Ctrl+Shift+F
• Supports clang-format, prettier, black, stylua, rustfmt
• Format on save option

AutoSave Plugin:

• Automatic file saving with configurable intervals
• Smart saving when content changes

Web Development Workflow

Traditional Workflow (Before v1.3.0)

# Terminal 1: Start external server
cd /path/to/project
python -m http.server 8080
# or
npx live-server

# Terminal 2: Edit files
loom index.html

# Manual browser refresh needed

New Integrated Workflow (v1.3.0+)

# Single command - everything integrated!
loom /path/to/web/project

# In Loom:
# 1. Tools → Start Live Server
# 2. Browser opens automatically
# 3. Edit files - auto-refresh!
# 4. Tools → Stop Live Server when done

Working Keyboard Shortcuts

All shortcuts work seamlessly with KTextEditor:

Shortcut	Action	Shortcut	Action
Ctrl+S	Save file	Ctrl+Z	Undo
Ctrl+O	Open file	Ctrl+Y	Redo
Ctrl+N	New file	Ctrl+C	Copy
Ctrl+T	New tab	Ctrl+V	Paste
Ctrl+W	Close file	Ctrl+X	Cut
Ctrl+Q	Quit	Ctrl+A	Select all
F11	Fullscreen	Ctrl+F	Find
F12	File tree	Ctrl+H	Replace
Ctrl+Shift+T	Toggle theme	Ctrl+Shift+F	Format code

Configuration

Configure everything in config/config.lua:

config = {
    theme = {
        name = "gruvbox Dark" -- 21 themes available
    },
    
    keybindings = {
        ["Ctrl+S"] = "save_file",
        ["F12"] = "toggle_file_tree",
        ["Ctrl+Shift+T"] = "toggle_theme",
        -- All shortcuts customizable
    },
    
    live_server = {
        enabled = true,
        port = "8080",
        auto_open_browser = true,
        log_level = "normal",
        show_output_in_console = true
    }
}

Build from Source

sudo apt install cmake qtbase5-dev liblua5.4-dev build-essential
git clone https://github.com/dexter-xd/loom.git
cd loom
./scripts/build_release.sh
./scripts/run_loom.sh

Package Information

• Size: ~4.5MB (includes live-server)
• Architecture: amd64 (x86_64)
• Dependencies: Qt5, Lua, KDE Frameworks (auto-installed)
• License: MIT

Support

• Issues: https://github.com/dexter-xd/loom/issues
• Source: https://github.com/dexter-xd/loom
• Discussions: https://github.com/dexter-xd/loom/discussions