Parker2991/vscodium
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
binary releases of VS Code without MS branding/telemetry/licensing
63 commits 2 branches 189 tags 33 MiB
C 97.1%
Shell 2.4%
XSLT 0.5%
Find a file
Peter Squicciarini 3ccdd1171d
Add script to trigger Azure pipelines build
2019-01-23 17:01:32 -05:00
src/resources New OSS icon (#25) 2018-10-11 09:02:11 -04:00
.gitignore Windows builds with Azure Pipelines (#58) 2018-11-27 09:19:34 -05:00
.travis.yml Add script to trigger Azure pipelines build 2019-01-23 17:01:32 -05:00
azure-pipelines.yml Cleanup Windows build process (#62) 2018-12-03 14:16:48 -05:00
build.sh Windows builds with Azure Pipelines (#58) 2018-11-27 09:19:34 -05:00
check_tags.ps1 Add null check for GH token 2018-12-22 17:14:08 -05:00
check_tags.sh do not hard code the repository 2018-10-11 17:43:47 +02:00
CODE_OF_CONDUCT.md Add code of conduct 2018-10-12 09:22:40 -04:00
create_zip.sh Use VSCodium in name of zip/tar 2019-01-10 14:55:28 -05:00
DOCS.md Add section for vscodium terminal support 2018-10-24 15:34:23 -04:00
get_repo.sh If vscode exists, fetch updates (#19) 2018-09-20 09:32:49 -04:00
install_deps.sh Use latest yarn (#57) 2018-11-13 11:58:05 -05:00
LICENSE Testing build 2018-08-13 11:14:15 -04:00
README.md Add choco installation instructions 2019-01-15 12:55:36 -05:00
trigger-azure.sh Add script to trigger Azure pipelines build 2019-01-23 17:01:32 -05:00
undo_telemetry.sh Undo telemetry before build (#27) 2018-10-05 09:43:05 -04:00
update_settings.sh Change default telemetry settings to disabled (#46) 2018-10-19 11:38:43 -04:00

README.md

current release windows_build_status build status license Gitter

Table of Contents

Download/Install

🎉 🎉 Download latest release here 🎉 🎉

Install with Brew (Mac)

If you are on a Mac and have Homebrew installed:

brew cask install vscodium

Note: if you see "App can’t be opened because it is from an unidentified developer" when opening VSCodium the first time, you can right-click the application and choose Open. This should only be required the first time opening on a Mac.

Install with Chocolatey (Windows)

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

choco install vscodium

Install with Package Manager (Linux)

You can always install using the downloads (deb, rpm, tar) on the releases page, but you can also install using your favorite package manager and get automatic updates. @paulcarroty has set up a repository with instructions here. Any issues installing VSCodium using your package manager should be directed to that repository's issue tracker.

Why Does This Exist

This repository contains a build file to generate FLOSS release binaries of Microsoft's VSCode.

Microsoft's downloads 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 enabled by a build flag which we do not pass.

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 VSCode.

Microsoft's build process does download additional files. This was brought up in Microsoft/vscode#49159 and Microsoft/vscode#45978. These are the packages downloaded during build:

More Info

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

Supported OS

  • OSX x64 (zipped app file)
  • Linux x64 (.deb, .rpm, and .tar.gz files)
  • Linux x86 (.deb, .rpm, and .tar.gz files)
  • Windows

The ARM architecture is not currently supported but is actively being worked on.

License

MIT