vscodium is a free, open source ides & code editors project written in Shell and released under MIT. It has 33,291 GitHub stars, 1,866 forks and 146 open issues, and was last pushed 2 days ago. On this registry it ranks #6 of 12 tracked projects in IDEs & Code Editors, with 5 head-to-head comparisons available.

What is vscodium?

VSCodium is a repository of scripts that automatically build Microsoft's vscode repository into freely-licensed binaries with a community-driven default configuration, made for developers who want the Visual Studio Code editing experience without Microsoft branding, telemetry, or licensing encumbrance.

What it is

VSCodium is not a fork. It is a set of Shell scripts that take Microsoft's upstream vscode source and compile it into binaries released under a free licence, with a default configuration decided by the community rather than by Microsoft. The project publishes both a stable channel and an insiders channel, and it targets macOS, Windows and GNU/Linux, with a documented list of supported platforms and a separate list of previously supported platforms. The repository itself carries the MIT licence, and it sits alongside a companion vscodium-insiders repository used for the pre-release builds.

The concrete problem it solves is licensing and configuration, not editing. Microsoft's published binaries of Visual Studio Code ship under a proprietary licence, are branded, and include telemetry. Anyone who wants the same editor but needs freely-licensed binaries, no Microsoft branding, and a configuration not dictated by Microsoft has to either rebuild the source themselves or install someone else's build. VSCodium replaces that manual rebuild effort with maintained automation: the scripts track Microsoft's vscode repository, apply the free-licensing and de-branding changes, and publish ready-to-install artefacts.

Key capabilities

  • Automated build scripts that compile Microsoft's vscode repository into freely-licensed binaries under the MIT licence.
  • A stable release channel and a separate insiders channel, published from the vscodium and vscodium-insiders repositories.
  • Community-driven default configuration, applied at build time rather than left to each user.
  • Package-manager delivery across ecosystems: brew install --cask vscodium, winget install -e --id VSCodium.VSCodium, choco install vscodium, and scoop install vscodium.
  • GNU/Linux distribution through the Snap Store as codium via snap install codium --classic, and through Flatpak.
  • Arch Linux packages vscodium-bin, vscodium-insiders-bin, and vscodium-electron, the last of which reuses the system-wide Electron to save disk space.
  • Direct downloads as deb, rpm, and tar artefacts on the releases page for both channels.

Who uses it and how

  • macOS developers who already use Homebrew and want VSCodium installed and updated through the same cask workflow, with vscodium@insiders available for pre-release testing.
  • Windows developers and fleets that standardise on WinGet, Chocolatey, or Scoop, installing by package identifier such as VSCodium.VSCodium.
  • GNU/Linux desktop users who prefer distro-native delivery, either the Snap or the Flatpak, rather than unpacking a tarball.
  • Administrators who want automatic editor updates through apt, dnf, or zypper, using the separate community repository set up for those package managers.
  • Arch users who want either the standard vscodium-bin package or the space-saving vscodium-electron variant.

Getting started

Download the latest stable or insiders build from the releases page, or install through whichever package manager applies: brew install --cask vscodium on macOS, winget install -e --id VSCodium.VSCodium or choco install vscodium on Windows, or snap install codium --classic on GNU/Linux.

How it compares

The only comparable tool named in the facts is Microsoft's own vscode repository, from which VSCodium builds rather than diverging. The distinguishing axes are the licence on the resulting binaries, the removal of Microsoft branding and telemetry, and the substitution of a community-driven default configuration for Microsoft's own defaults.

When to use it — and when not to

VSCodium is the right choice when freely-licensed binaries, no telemetry, and community-controlled defaults matter more than vendor alignment. It is the wrong choice for anyone who wants Microsoft's exact branding and configuration, or who expects support from the project for installs delivered through the third-party apt/dnf/zypper repository or the AUR packages, since the README directs those issues to the respective maintainers rather than to VSCodium itself. Support is therefore split across the project and several community channels, which a self-hoster or administrator should account for before standardising on it.

project readme (upstream, from github) — read inline

VSCodium

Free/Libre Open Source Software Binaries of Visual Studio Code

current release license Gitter codium codium

This is not a fork. This is a repository of scripts to automatically build Microsoft's vscode repository into freely-licensed binaries with a community-driven default configuration.

Table of Contents

Download/Install

:tada: :tada: Download latest release here: stable or insiders :tada: :tada:

More info / helpful tips are here.

Install with Brew (Mac)

If you are on a Mac and have Homebrew installed:

# stable
brew install --cask vscodium

# insiders
brew install --cask vscodium@insiders
Install with Windows Package Manager (WinGet)

If you use Windows and have Windows Package Manager installed:

:: stable
winget install -e --id VSCodium.VSCodium

:: insider
winget install -e --id VSCodium.VSCodium.Insiders
Install with Chocolatey (Windows)

If you use Windows and have Chocolatey installed (thanks to @Thilas):

:: stable
choco install vscodium

:: insider
choco install vscodium-insiders
Install with Scoop (Windows)

If you use Windows and have Scoop installed:

scoop bucket add extras
scoop install vscodium
Install with snap (GNU/Linux)

VSCodium is available in the Snap Store as Codium, thanks to the help of the Snapcrafters community. If your GNU/Linux distribution has support for snaps:

snap install codium --classic
Install with Package Manager (GNU/Linux)

You can always install using the downloads (deb, rpm, tar) on the releases page for stable or insiders, but you can also install using your favorite package manager and get automatic updates.

@paulcarroty has set up a repository with instructions for apt, dnf and zypper here.

Any issues installing VSCodium using your package manager should be directed to that repository's issue tracker.

Install on Arch Linux

VSCodium is available in AUR, maintained by @binex-dsk as package vscodium-bin (stable) and as vscodium-insiders-bin.

If you want to save disk space by having VSCodium use the Electron system-wide, you also have vscodium-electron, maintained by @m00nw4tch3r.

An alternative package vscodium-git, maintained by @cedricroijakkers, is also available should you wish to compile from source yourself.

Flatpak Option (GNU/Linux)

VSCodium is available as a Flatpak app here and the build repo is here. If your distribution has support for flatpak, and you have enabled the flathub repo:

flatpak install flathub com.vscodium.codium
flatpak run com.vscodium.codium

Build

Build instructions can be found here

Why Does This Exist

This repository contains build files to generate free release binaries of Microsoft's Visual Studio Code. When we speak of "free software", we're talking about freedom, not price.

Microsoft's releases of Visual Studio Code are licensed under this not-FLOSS license and contain telemetry/tracking. According to this comment from a Visual Studio Code maintainer:

When we [Microsoft] build Visual Studio Code, we do exactly this. We clone the vscode repository, we lay down a customized product.json that has Microsoft specific functionality (telemetry, gallery, logo, etc.), and then produce a build that we release under our license.

When you clone and build from the vscode repo, none of these endpoints are configured in the default product.json. Therefore, you generate a "clean" build, without the Microsoft customizations, which is by default licensed under the MIT license

This repo exists so that you don't have to download+build from source. The build scripts in this repo clone Microsoft's vscode repo, run the build commands, and upload the resulting binaries to GitHub releases. These binaries are licensed under the MIT license. Telemetry is disabled.

If you want to build from source yourself, head over to Microsoft's vscode repo and follow their instructions. This repo exists to make it easier to get the latest version of MIT-licensed Visual Studio Code.

Microsoft's build process (which we are running to build the binaries) does download additional files. Those packages downloaded during build are:

More Info

Documentation

For more information on getting all the telemetry disabled, tips for migrating from Visual Studio Code to VSCodium and more, have a look at the Docs page page.

Troubleshooting

If you have any issue, please check the Troubleshooting page or the existing issues.

Extensions and the Marketplace

According to the Visual Studio Marketplace Terms of Use, you may only install and use Marketplace Offerings with Visual Studio Products and Services. For this reason, VSCodium uses open-vsx.org, an open source registry for Visual Studio Code extensions. See the Extensions + Marketplace section on the Docs page for more details.

Please note that some Visual Studio Code extensions have licens

readme truncated — read the full docs on github

Frequently asked questions

Is vscodium free to use?

vscodium is open source under the MIT licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does vscodium do?

binary releases of VS Code without MS branding/telemetry/licensing

What is vscodium written in?

vscodium is primarily written in Shell. Its source is publicly available at https://github.com/VSCodium/vscodium, and it has 33,291 GitHub stars.