Scoop README

The project's README from github.com/ScoopInstaller/Scoop. As one markdown file: README.md.

Scoop

Features | Installation | Documentation


Code Size Repository size Scoop Core CI Tests Discord Chat Gitter Chat License

Scoop is a command-line installer for Windows.

What does Scoop do?

Scoop installs apps from the command line with a minimal amount of friction. It:

Scoop is quite script-friendly. Your environment can become the way you like by using repeatable setups. For example:

scoop install sudo
sudo scoop install 7zip git openssh --global
scoop install aria2 curl grep sed less touch
scoop install python ruby go perl

If you have built software that you would like others to use, Scoop is an alternative to building an installer (like MSI or InnoSetup). You just need to compress your app to a .zip file and provide a JSON manifest that describes how to install it.

Installation

Run the following commands from a regular (non-admin) PowerShell terminal to install Scoop:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

Note: The first command makes your device allow running the installation and management scripts. This is necessary because Windows 10 client devices restrict execution of any PowerShell scripts by default.

It will install Scoop to its default location:

C:\Users\<YOUR USERNAME>\scoop

You can find the complete documentation about the installer, including advanced installation configurations, in ScoopInstaller/Install. Please create new issues there if you have questions about the installation.

Multi-connection downloads with aria2

Scoop can utilize aria2 to use multi-connection downloads. Simply install aria2 through Scoop and it will be used for all downloads afterward.

scoop install aria2

By default, scoop displays a warning when running scoop install or scoop update while aria2 is enabled. This warning can be suppressed by running scoop config aria2-warning-enabled false.

You can tweak the following aria2 settings with the scoop config command:

Inspiration

What sort of apps can Scoop install?

The apps that are most likely to get installed fine with Scoop are those referred to as "portable" apps. These apps are compressed files which can run standalone after being extracted. This type of apps does not produce side effects like changing the Windows Registry or placing files outside the app directory.

Scoop also supports installer files and their uninstallation methods. Likewise, it can handle single-file apps and PowerShell scripts. These do not even need to be compressed. See the runat package for an example: it is simply a GitHub gist.

Contribute to this project

If you would like to improve Scoop by adding features or fixing bugs, please read our Contributing Guide.

Support this project

If you find Scoop useful and would like to support the ongoing development and maintenance of this project, you can donate here:

Known application buckets

The following buckets are known to Scoop:

The main bucket is installed by default. You can make use of more buckets by typing:

scoop bucket add <name>

For example, to add the extras bucket, type:

scoop bucket add extras

You would be able to install apps from the extras bucket now.

Other application buckets

Many other application buckets hosted on GitHub can be found on ScoopSearch or via other search engines.

Scoop (ScoopInstaller/Scoop)

Searching Database…

24.8K ·GitHub
这是什么?Scoop 是一款适用于 Windows 的命令行安装工具,让你可以在终端中安装应用,操作简单省事,类似于 macOS 上的 Homebrew。
这是图形界面应用还是命令行工具?这是一个 PowerShell 命令行工具,没有图形界面,应用的安装和管理完全通过终端命令完成。
我该如何安装 Scoop 本身?请在普通的非管理员 PowerShell 终端中运行安装命令;默认会安装到 C:\Users\ \scoop。完整说明和高级配置选项请参阅单独的 ScoopInstaller/Install 仓库。
我需要先更改 Windows 的某些设置吗?需要允许运行 PowerShell 脚本,因为 Windows 10 默认限制脚本执行;安装程序的第一条命令会设置这一执行策略。
哪些类型的应用真正能顺利通过 Scoop 安装?便携式的独立压缩包应用效果最好,因为它们不会修改注册表,也不会在应用目录之外写入文件。Scoop 也支持常规安装程序以及单文件或脚本类应用,但属于“nonportable”仓库(bucket)的应用仍可能触发 UAC 提示。
这只能在 Windows 上使用吗?是的,Scoop 专为 Windows 打造,并使用 PowerShell 编写。
除了 main 之外,Scoop 还自带哪些仓库(bucket)?已知的仓库包括 extras(不适合放入 main 的应用)、games、nerd-fonts、nirsoft、sysinternals、java、nonportable、php 和 versions(用于安装应用的其他版本)。默认只安装 main,其他仓库需要使用 'scoop bucket add' 命令添加。
我能加快下载速度吗?可以。通过 Scoop 安装 aria2 后,之后的所有安装都会自动启用多连接下载,还可以通过 scoop config 调整 aria2-split、aria2-max-connection-per-server 等设置。
我能通过 Scoop 发布自己的应用吗?可以。你只需把应用打包成 zip 压缩包,并编写一个描述安装方式的 JSON 清单(manifest)即可,这样 Scoop 就成了制作传统 MSI 或 InnoSetup 安装程序的一种替代方案。
Scoop 的灵感来自哪里?Scoop 的灵感来自 Homebrew(macOS)以及一个名为 Sub 的工具。
Size
14.2 MB
Stars
24.8K
Age
13y
Commits · 90 Days