{"id":44713882,"url":"https://github.com/debuggerdragon311/zedx-appimage","last_synced_at":"2026-03-08T01:13:00.363Z","repository":{"id":338605117,"uuid":"1158430237","full_name":"debuggerdragon311/zedx-appimage","owner":"debuggerdragon311","description":"Portable AppImage build of Zed editor using my personal editor config. This is the setup I use myself, shared publicly for anyone who wants to use it. Runs anywhere on Linux with zero to very less configuration required.","archived":false,"fork":false,"pushed_at":"2026-02-20T03:53:48.000Z","size":4536,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-20T07:20:23.384Z","etag":null,"topics":["appimage","appimages","linux","portable","rust","zed","zed-editor"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/debuggerdragon311.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-15T11:07:47.000Z","updated_at":"2026-02-17T14:38:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/debuggerdragon311/zedx-appimage","commit_stats":null,"previous_names":["debuggerdragon311/zedx-appimage"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/debuggerdragon311/zedx-appimage","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/debuggerdragon311%2Fzedx-appimage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/debuggerdragon311%2Fzedx-appimage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/debuggerdragon311%2Fzedx-appimage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/debuggerdragon311%2Fzedx-appimage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/debuggerdragon311","download_url":"https://codeload.github.com/debuggerdragon311/zedx-appimage/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/debuggerdragon311%2Fzedx-appimage/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29674928,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T05:54:28.202Z","status":"ssl_error","status_checked_at":"2026-02-21T05:53:42.585Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["appimage","appimages","linux","portable","rust","zed","zed-editor"],"created_at":"2026-02-15T13:10:51.866Z","updated_at":"2026-03-08T01:13:00.354Z","avatar_url":"https://github.com/debuggerdragon311.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- \u003e[!WARNING]\n\u003e **🚧 MAINTENANCE IN PROGRESS**  \n\u003e I'm improving compatibility across Linux distributions. New builds with better glibc support coming within 24-48 hours.  \n\u003e [Last stable release available here](https://github.com/debuggerdragon311/zedx-appimage/releases/tag/v0.223.4)\n--\u003e\n\n\n# ZedX AppImage\n[![Zed](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/zed-industries/zed/main/assets/badge/v0.json)](https://zed.dev)\n[![Zed Version](https://img.shields.io/badge/Zed-v0.226.5-lightgreen.svg)](https://zed.dev)\n[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)\n[![GitHub release](https://img.shields.io/github/release/debuggerdragon311/zedx-appimage.svg)](https://github.com/debuggerdragon311/zedx-appimage/releases/v0.223.4)\n[![Maintained](https://img.shields.io/badge/Maintained-Yes-green.svg)](https://github.com/debuggerdragon311/zedx-appimage)\n\n\u003e Portable, self-contained AppImage builds of the Zed high-performance code editor. Zero installation, maximum performance.\n\n\u003cimg width=\"1288\" height=\"804\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/687a86c4-b5e7-4082-84ce-516079145a06\" /\u003e\n\n## Why ZedX AppImage?\n\nThe [Zed editor](https://zed.dev) is blazing fast, but lacks official AppImage releases. ZedX bridges that gap with:\n\n- ✅ **Zero Installation** – Download once, run anywhere on any Linux distribution\n- 🚀 **GPU Accelerated** – Full Vulkan support for 120 FPS rendering\n- 📦 **Truly Portable** – All dependencies bundled (OpenSSL, XCB, XKB libraries included)\n- 🔒 **Stable \u0026 Tested** – Built from official Zed source with quality assurance\n- 💾 **Lightweight** – \u003c150 MB compressed package with everything you need\n\n## Downloads\n\n**Choose the right build for your system:**\n\n### 🏔️ Arch Build (Bleeding Edge)\n- **File:** `zedX-v0.223.3-arch-x86_64.AppImage`\n- **For:** Arch Linux, Fedora 40+, openSUSE Tumbleweed, and other rolling-release distros\n- **Requirements:** glibc 2.38+ (check with `ldd --version`)\n- **Optimized for:** Latest features and performance\n\n### 🐧 Compatible Build (Stable Distros)\n- **File:** `zedX-v0.223.3-compat-x86_64.AppImage`\n- **For:** Debian 11-12, Ubuntu 20.04-24.04, RHEL 8-9, and enterprise Linux\n- **Requirements:** glibc 2.31+ (most stable distros)\n- **Recommended for:** Maximum compatibility\n\n**Not sure which to download?** → Use the **compat** build (works everywhere)\n\n[📥 Download Latest Release](https://github.com/debuggerdragon311/zedx-appimage/releases/latest)\n\n## Quick Start\n\n```bash\n# Download the compatible build (recommended)\nwget https://github.com/debuggerdragon311/zedx-appimage/releases/latest/download/zedX-v0.223.4-compat+mix-x86_64.AppImage\n\n# Make it executable\nchmod +x zedX-v0.223.4-compat+mix-x86_64.AppImage\n\n# Run immediately\n./zedX-v0.223.4-compat+mix-x86_64.AppImage\n```\n\n**That's it!** No package managers, no dependency hunting, no root required.\n\n## Portable Mode\n\nCreate `.home` and `.config` folders next to the AppImage to keep all settings portable:\n\n```bash\n# Create portable directories\nmkdir zedX-v0.223.4-compat+mix-x86_64.AppImage.{home,config}\n\n# Run - settings will be stored in these folders\n./zedX-v0.223.4-compat+mix-x86_64.AppImage\n```\n\nAll configuration and data will be stored in these folders instead of `~/.config/`, making it truly portable across machines or USB drives.\n\n## Building from Source\n\nWant to build your own? Here's how:\n\n### Prerequisites\n\n```bash\n# Install Rust toolchain\ncurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\n\n# Clone Zed source\ngit clone https://github.com/zed-industries/zed.git\ncd zed\n\n# Build release binary\ncargo build --release\n\n# The binary will be at: target/release/zed\n```\n\n### Create the AppImage\n\n```bash\n# Clone this repository\ngit clone https://github.com/debuggerdragon311/zedx-appimage.git\ncd zedx-appimage\n\n# Copy the Zed binary you just built\ncp /path/to/zed/target/release/zed zed.fk.app/usr/bin/zed\nchmod +x zed.fk.app/usr/bin/zed\n\n# Download appimagetool\nwget https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage\nchmod +x appimagetool-x86_64.AppImage\n\n# Build the AppImage\n./appimagetool-x86_64.AppImage zed.fk.app zedX-v0.223.4-compat+mix-x86_64.AppImage\n```\n\n### Building for Maximum Compatibility\n\nFor the `-compat` build, we recommend building on Debian 12 or Ubuntu 22.04:\n\n```bash\n# On Debian 12 / Ubuntu 22.04\nsudo apt update \u0026\u0026 sudo apt install -y \\\n    build-essential clang cmake curl git pkg-config \\\n    libx11-dev libx11-xcb-dev libxcb1-dev libxcb-render0-dev \\\n    libxcb-shape0-dev libxcb-xfixes0-dev libxkbcommon-dev \\\n    libxkbcommon-x11-dev libssl-dev libfontconfig1-dev \\\n    libfreetype6-dev libasound2-dev libvulkan-dev libwayland-dev \\\n    libxcursor-dev libxi-dev libxrandr-dev mesa-vulkan-drivers libzstd-dev\n\n# Install Rust\ncurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\nsource \"$HOME/.cargo/env\"\n\n# Build\nexport CC=clang\nexport CXX=clang++\ncd zed\ncargo build --release -j 2\n```\n\n## Troubleshooting\n\n### Error: GLIBC version not found\n\nYou downloaded the `-arch` build but need the `-compat` build instead.\n\n**Solution:** Download the `-compat` variant from releases.\n\n**How to check your glibc version:**\n```bash\nldd --version\n```\n\nIf you see 2.36 or lower → use `-compat`  \nIf you see 2.38 or higher → either build works\n\n### Permission Denied on External Drives\n\nIf you get `execv error: Permission denied`:\n\n```bash\n# Move to your home directory\nmv zedX-*.AppImage ~/\ncd ~\n./zedX-*.AppImage\n```\n\nThis happens when external drives are mounted with the `noexec` flag for security.\n\n### Missing Vulkan Drivers\n\nEnsure your GPU drivers are up to date:\n\n```bash\n# Check Vulkan support\nvulkaninfo | grep \"deviceName\"\n\n# Install Vulkan (if missing)\n# Arch: sudo pacman -S vulkan-icd-loader\n# Debian/Ubuntu: sudo apt install mesa-vulkan-drivers\n# Fedora: sudo dnf install vulkan-loader\n```\n\n## Project Structure\n\n```\nzedx-appimage/\n├── LICENSE                    # AGPL-3.0 license\n├── README.md                  # This file\n└── zed.fk.app/               # AppImage source directory\n    ├── AppRun                # Launch script with portable mode support\n    ├── zed.desktop           # Desktop integration\n    ├── zed.png               # Application icon (512x512)\n    └── usr/\n        ├── bin/              # Binary location\n        ├── lib/              # Bundled libraries (OpenSSL, XCB, etc.)\n        └── share/            # Desktop files and icons\n```\n\n## What's Included\n\n- **Zed Binary:** Built from official source (v0.225.0+dev)\n- **Bundled Libraries:**\n  - OpenSSL 3.x (`libssl.so.3`, `libcrypto.so.3`)\n  - ALSA audio (`libasound.so.2`)\n  - X11/Wayland support (`libxcb-xkb`, `libxkbcommon`)\n  - C++ runtime (`libstdc++.so.6`)\n\n## Roadmap\n\n- [x] Multiple build variants for different distros\n- [x] Portable configuration support\n- [ ] Automated builds on new Zed releases\n- [ ] Multiple architecture support (ARM64)\n- [ ] Integration with AppImageHub\n- [ ] Delta updates for faster releases\n\n## Release Cadence\n\nZedX AppImage follows Zed's official releases with a slight delay for building and testing:\n\n| Release Type | Description | Status |\n|--------------|-------------|--------|\n| 🔥 **Development** | Latest `main` branch features | Usually available within 24h |\n| 🧪 **Pre-release** | Beta versions for testing | Available on request |\n| ✅ **Stable** | Production-ready releases | Priority, typically within 48h |\n\n**Current Status:**\n- Latest Dev: ✅ v0.225.0+dev (multiple variants)\n- Stable: ✅ v0.223.3\n\n## FAQ\n\n### Which AppImage should I download?\n\n**Short answer:** Download the `-compat` build unless you're on Arch/Fedora.\n\n**Long answer:**\n- `-arch`: Built on latest systems, optimized for bleeding-edge distros (glibc 2.38+)\n- `-compat`: Built on Debian 12, works on stable and older systems (glibc 2.31+)\n\n### Can I run multiple instances?\n\nYes! Use the `--new-window` flag:\n\n```bash\n./zedX-*.AppImage --new-window\n```\n\n### How do I update?\n\nSimply download the new AppImage and replace the old one. Your settings in `~/.config/zed/` are preserved (or in portable `.config/` folder if using portable mode).\n\n## Contributing\n\nContributions welcome! Feel free to:\n- Report bugs via [Issues](https://github.com/debuggerdragon311/zedx-appimage/issues)\n- Submit improvements via [Pull Requests](https://github.com/debuggerdragon311/zedx-appimage/pulls)\n- Request features or suggest optimizations\n\n## Credits\n\n- **[Zed Industries](https://zed.dev)** – Original Zed editor developers\n- **[AppImageKit](https://github.com/AppImage/AppImageKit)** – Portable packaging framework\n- **Community** – Testing and feedback\n\n## License\n\nThis repository is licensed under **AGPL-3.0** to match Zed's licensing requirements.\n\n- **Zed Editor:** [AGPL-3.0](https://github.com/zed-industries/zed/blob/main/LICENSE-AGPL) or [GPL-3.0](https://github.com/zed-industries/zed/blob/main/LICENSE-GPL)\n- **Build Scripts \u0026 Packaging:** AGPL-3.0 (this repository)\n\n## Important Disclaimer\n\n⚠️ **This is an UNOFFICIAL community-maintained build.**\n\n- **Not affiliated with:** Zed Industries, Inc.\n- **Not endorsed by:** The official Zed development team\n- **Official releases:** Available at [zed.dev](https://zed.dev)\n- **Support:** For Zed-specific issues, please visit the [official repository](https://github.com/zed-industries/zed)\n\n**Quality Commitment:** While this is an unofficial build, I am committed to:\n- ✓ Building from official, unmodified Zed source code\n- ✓ Regular updates following upstream releases\n- ✓ Transparency in build process and dependencies\n- ✓ Prompt bug fixes and community support\n\nFor official support, enterprise features, or commercial use, please visit [zed.dev](https://zed.dev).\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made with ⚡ for the Linux community\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdebuggerdragon311%2Fzedx-appimage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdebuggerdragon311%2Fzedx-appimage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdebuggerdragon311%2Fzedx-appimage/lists"}