Codex Editor
Getting Started

Download Codex Editor

Download and install Codex Editor on macOS, Windows, and Linux

Download Codex Editor to start your translation journey. The application is available for macOS, Windows, and Linux platforms, with specific builds optimized for different system architectures.

System Requirements

Minimum Requirements

  • RAM: 4GB (8GB recommended)
  • Storage: 2GB free space for the application
  • Internet: Required for initial setup and collaboration via our GitLab cloud service

Project Storage

In addition to the application itself, you'll need disk space for your translation projects:

  • Text-only projects: Text and version history are lightweight — most projects stay well under 500MB.

  • Audio projects: Audio recordings add up quickly depending on length and format. For reference:

    • A 30-second clip (e.g., a single verse or short paragraph): ~5MB uncompressed (WAV), under 1MB compressed (MP3)
    • A 10-minute recording (roughly the length of a typical YouTube video): ~100MB WAV, ~10MB MP3
    • A 30-minute recording (a book chapter or short podcast episode): ~300MB WAV, ~30MB MP3
    • A 45-minute recording (a TV episode): ~450MB WAV, ~45MB MP3

    Audio storage scales with your project's scope and recording format. Compressed formats (MP3, OGG) use roughly one-tenth the space of uncompressed WAV. Plan your disk space accordingly based on how much audio your project will involve.

Supported Operating Systems

  • macOS: 10.15 (Catalina) or later
  • Windows: Windows 10 or later
  • Linux: Most modern distributions (Ubuntu 20.04+, Fedora 36+, or equivalent)

Download Options

Visit codexeditor.app to access the download page with platform-specific options.

Installation Instructions

Determining Your Mac Type

Before downloading, you need to identify your Mac's processor type:

Apple Silicon Macs (M1, M2, M3, M4 series)

  • Released 2020 or later
  • Check: Apple Menu → About This Mac → look for "Apple M1", "Apple M2", etc.
  • Or run in Terminal: uname -m (returns "arm64")

Intel Macs

  • Released before 2020 (and some 2020 models)
  • Check: Apple Menu → About This Mac → look for "Intel" processor
  • Or run in Terminal: uname -m (returns "x86_64")

Download Steps

  1. Visit codexeditor.app
  2. Click the macOS button at the top of the page
  3. Select your Mac type from the dropdown:
    • Apple Silicon - for M1, M2, M3, M4 Macs
    • Intel - for older Intel-based Macs
  4. The download will begin automatically

Installation Process

  1. Once downloaded, open the .dmg file
  2. Drag Codex Editor to your Applications folder

Download Steps

  1. Visit codexeditor.app
  2. Click the Windows button at the top of the page
  3. The download will start automatically (x64.exe file)

Installation Process

  1. Locate the downloaded .exe file (usually in Downloads folder)
  2. Double-click to run the installer
  3. Important: You may see Windows security warnings

Handling Windows Security (Unsigned Application)

Windows may show security warnings because the application isn't code-signed:

  1. SmartScreen Warning: If you see "Windows protected your PC"
    • Click "More info"
    • Click "Run anyway"
  2. User Account Control: Allow the installer to make changes
  3. Follow the installation wizard prompts

What "Unsigned" Means: The application doesn't have a digital signature from a recognized certificate authority (aka Microsoft). Windows flags this as potentially risky, but it's safe to proceed.

Determining Your Architecture

Before downloading, identify your system architecture:

uname -m

Common Results:

  • x86_64 → Choose x64
  • aarch64 → Choose arm64
  • armv7l → Choose armhf

Download Steps

  1. Visit codexeditor.app
  2. Click the Linux button at the top of the page
  3. Select your architecture from the dropdown:
    • x64 - Most common for desktop/laptop computers
    • arm64 - For 64-bit ARM processors (like Raspberry Pi 4, Apple Silicon via emulation)
    • armhf - For 32-bit ARM processors (older Raspberry Pi models)

Installation Process

The exact installation method depends on the package format provided:

For .deb packages (Ubuntu/Debian):

sudo dpkg -i codex-editor*.deb
sudo apt-get install -f  # Fix dependencies if needed

For .AppImage files:

chmod +x codex-editor*.AppImage
./codex-editor*.AppImage

For .tar.gz archives:

tar -xzf codex-editor*.tar.gz
cd codex-editor
./codex-editor

Handling Linux Security (Unsigned Application)

Linux systems may require additional permissions:

  1. Executable Permissions: You may need to make the file executable

    chmod +x codex-editor
  2. Package Manager Warnings: Some package managers may warn about unsigned packages

    • This is normal for applications not in official repositories
    • Proceed with installation when prompted

What "Unsigned" Means: The package isn't signed with a recognized GPG key or distributed through official repositories. This is common for third-party applications.

Post-Installation Steps

After successfully installing Codex Editor:

  1. Launch the Application: Find and open Codex Editor
  2. Initial Setup: Creating your account
  3. Start Your Project: Create your first translation project

Need Help?

If you encounter issues during download or installation:

Next Steps

Once Codex Editor is installed and running:

  1. Complete the initial setup
  2. Start your first translation project

On this page