Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
 Felitendo
|
e1c77f049f | ||
|
Felitendo
|
fa624380b1 | ||
|
Felitendo
|
d8900ef80f | ||
|
Felitendo
|
46e63e9faa | ||
|
Felitendo
|
af82ffec78 | ||
|
Felitendo
|
b7e0ff6fd1 | ||
|
Felitendo
|
ced6f57dfd | ||
|
Felitendo
|
21e29d99c3 | ||
|
Felitendo
|
c31c7b92e5 | ||
|
Felitendo
|
0bbf0cbd9f | ||
|
Felitendo
|
70f6748f3c | ||
|
Felitendo
|
aaa41f0384 | ||
|
Felitendo
|
a053b4e555 | ||
|
Felitendo
|
36498f2acf | ||
|
Felitendo
|
bd84c6645a | ||
|
Felitendo
|
f42d80598f | ||
|
Felitendo
|
4004023297 | ||
|
Felitendo
|
9896260636 | ||
|
Felitendo
|
5b1fc84710 | ||
|
Felitendo
|
d3c82fdff8 |
No files matched your search
@@ -0,0 +1,2 @@
|
|||||||
|
# Auto detect text files and perform LF normalization
|
||||||
|
* text=auto
|
||||||
@@ -0,0 +1,28 @@
|
|||||||
|
name: check
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
pull_request:
|
||||||
|
workflow_dispatch:
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
check:
|
||||||
|
name: syntax and shellcheck
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v7
|
||||||
|
|
||||||
|
# The Makefile skips whatever is missing rather than failing, so the
|
||||||
|
# tools it looks for have to be here or the check checks less than it
|
||||||
|
# appears to.
|
||||||
|
- name: Install the tools the Makefile looks for
|
||||||
|
run: |
|
||||||
|
sudo apt-get update -qq
|
||||||
|
sudo apt-get install -y --no-install-recommends \
|
||||||
|
shellcheck gettext scdoc
|
||||||
|
|
||||||
|
- run: make check
|
||||||
|
|
||||||
|
- name: Build the catalogs and the man page
|
||||||
|
run: make build
|
||||||
@@ -0,0 +1,256 @@
|
|||||||
|
name: release
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
tags: ['v*']
|
||||||
|
workflow_dispatch:
|
||||||
|
inputs:
|
||||||
|
dry_run:
|
||||||
|
description: >-
|
||||||
|
Build the repositories with a throwaway key and install from them,
|
||||||
|
without publishing anything. This is how the release path gets
|
||||||
|
exercised without cutting a tag.
|
||||||
|
type: boolean
|
||||||
|
default: false
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
contents: write
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
deb:
|
||||||
|
name: Debian package
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
container: debian:stable
|
||||||
|
steps:
|
||||||
|
- name: Install the build tools
|
||||||
|
run: |
|
||||||
|
apt-get update -qq
|
||||||
|
apt-get install -y --no-install-recommends \
|
||||||
|
ca-certificates git make gettext scdoc dpkg-dev
|
||||||
|
|
||||||
|
- uses: actions/checkout@v7
|
||||||
|
|
||||||
|
- name: Check the tag against the Makefile
|
||||||
|
run: packaging/check-version.sh "${{ github.ref_name }}"
|
||||||
|
|
||||||
|
- run: packaging/build-deb.sh
|
||||||
|
|
||||||
|
- name: Look inside what was built
|
||||||
|
run: |
|
||||||
|
dpkg-deb --info dist/*.deb
|
||||||
|
dpkg-deb --contents dist/*.deb
|
||||||
|
|
||||||
|
- uses: actions/upload-artifact@v7
|
||||||
|
with:
|
||||||
|
name: deb
|
||||||
|
path: dist/*.deb
|
||||||
|
if-no-files-found: error
|
||||||
|
|
||||||
|
rpm:
|
||||||
|
name: RPM package
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
container: fedora:latest
|
||||||
|
steps:
|
||||||
|
- name: Install the build tools
|
||||||
|
run: |
|
||||||
|
dnf install -y --setopt=install_weak_deps=False \
|
||||||
|
git make gettext scdoc tar rpm-build rpm-sign systemd-rpm-macros
|
||||||
|
|
||||||
|
- uses: actions/checkout@v7
|
||||||
|
|
||||||
|
- name: Check the tag against the Makefile
|
||||||
|
run: packaging/check-version.sh "${{ github.ref_name }}"
|
||||||
|
|
||||||
|
- run: packaging/build-rpm.sh
|
||||||
|
|
||||||
|
# Signed here rather than alongside the APT repository, because this is
|
||||||
|
# the one place with a native rpm-sign. A dry run signs with a key it
|
||||||
|
# makes on the spot, so the command itself is still exercised.
|
||||||
|
- name: Sign the package
|
||||||
|
env:
|
||||||
|
GPG_PRIVATE_KEY: ${{ secrets.GPG_PRIVATE_KEY }}
|
||||||
|
DRY_RUN: ${{ inputs.dry_run }}
|
||||||
|
run: |
|
||||||
|
if [ "$DRY_RUN" = "true" ]; then
|
||||||
|
gpg --batch --passphrase '' --quick-generate-key \
|
||||||
|
'dry run <dry-run@example.invalid>' rsa2048 sign never
|
||||||
|
elif [ -n "${GPG_PRIVATE_KEY:-}" ]; then
|
||||||
|
printf '%s' "$GPG_PRIVATE_KEY" | gpg --batch --import
|
||||||
|
else
|
||||||
|
echo "No GPG_PRIVATE_KEY secret; leaving the package unsigned."
|
||||||
|
exit 0
|
||||||
|
fi
|
||||||
|
keyid="$(gpg --list-secret-keys --with-colons | awk -F: '/^sec:/ { print $5; exit }')"
|
||||||
|
rpmsign --define "_gpg_name $keyid" --addsign dist/*.rpm
|
||||||
|
gpg --armor --export "$keyid" > dist/rpm-signer.asc
|
||||||
|
rpm --import dist/rpm-signer.asc
|
||||||
|
rpm --checksig dist/*.rpm
|
||||||
|
|
||||||
|
- name: Look inside what was built
|
||||||
|
run: |
|
||||||
|
rpm -qip dist/*.rpm
|
||||||
|
rpm -qlp dist/*.rpm
|
||||||
|
|
||||||
|
- uses: actions/upload-artifact@v7
|
||||||
|
with:
|
||||||
|
name: rpm
|
||||||
|
path: |
|
||||||
|
dist/*.rpm
|
||||||
|
dist/rpm-signer.asc
|
||||||
|
if-no-files-found: error
|
||||||
|
|
||||||
|
publish:
|
||||||
|
name: Release and repositories
|
||||||
|
needs: [deb, rpm]
|
||||||
|
if: startsWith(github.ref, 'refs/tags/v') || inputs.dry_run
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v7
|
||||||
|
|
||||||
|
- uses: actions/download-artifact@v8
|
||||||
|
with:
|
||||||
|
path: incoming
|
||||||
|
merge-multiple: true
|
||||||
|
|
||||||
|
- name: Attach the packages to the release
|
||||||
|
if: ${{ !inputs.dry_run }}
|
||||||
|
env:
|
||||||
|
GH_TOKEN: ${{ github.token }}
|
||||||
|
run: |
|
||||||
|
gh release create "${{ github.ref_name }}" \
|
||||||
|
--title "${{ github.ref_name }}" \
|
||||||
|
--generate-notes \
|
||||||
|
incoming/*.deb incoming/*.rpm \
|
||||||
|
|| gh release upload "${{ github.ref_name }}" \
|
||||||
|
incoming/*.deb incoming/*.rpm --clobber
|
||||||
|
|
||||||
|
- name: Install the repository tools
|
||||||
|
run: |
|
||||||
|
sudo apt-get update -qq
|
||||||
|
sudo apt-get install -y --no-install-recommends \
|
||||||
|
dpkg-dev apt-utils createrepo-c
|
||||||
|
|
||||||
|
- name: Get a signing key
|
||||||
|
id: key
|
||||||
|
env:
|
||||||
|
GPG_PRIVATE_KEY: ${{ secrets.GPG_PRIVATE_KEY }}
|
||||||
|
DRY_RUN: ${{ inputs.dry_run }}
|
||||||
|
run: |
|
||||||
|
if [ "$DRY_RUN" = "true" ]; then
|
||||||
|
gpg --batch --passphrase '' --quick-generate-key \
|
||||||
|
'dry run <dry-run@example.invalid>' rsa2048 sign never
|
||||||
|
elif [ -n "${GPG_PRIVATE_KEY:-}" ]; then
|
||||||
|
printf '%s' "$GPG_PRIVATE_KEY" | gpg --batch --import
|
||||||
|
else
|
||||||
|
echo "present=no" >> "$GITHUB_OUTPUT"
|
||||||
|
echo "::warning::No GPG_PRIVATE_KEY secret - the apt and dnf repositories were not updated. The packages are on the release."
|
||||||
|
exit 0
|
||||||
|
fi
|
||||||
|
echo "present=yes" >> "$GITHUB_OUTPUT"
|
||||||
|
|
||||||
|
- name: Check out the published repositories
|
||||||
|
if: steps.key.outputs.present == 'yes' && !inputs.dry_run
|
||||||
|
uses: actions/checkout@v7
|
||||||
|
with:
|
||||||
|
ref: gh-pages
|
||||||
|
path: pages
|
||||||
|
continue-on-error: true
|
||||||
|
|
||||||
|
- name: Update the repositories
|
||||||
|
if: steps.key.outputs.present == 'yes'
|
||||||
|
run: |
|
||||||
|
# First release, or a dry run: there is no branch to start from.
|
||||||
|
if [ ! -d pages/.git ]; then
|
||||||
|
rm -rf pages && mkdir pages
|
||||||
|
git -C pages init -q -b gh-pages
|
||||||
|
git -C pages remote add origin "https://github.com/${{ github.repository }}.git"
|
||||||
|
fi
|
||||||
|
rm -f incoming/rpm-signer.asc
|
||||||
|
packaging/publish-repos.sh pages incoming
|
||||||
|
|
||||||
|
- name: Check that what was written can be verified
|
||||||
|
if: steps.key.outputs.present == 'yes'
|
||||||
|
run: |
|
||||||
|
find pages -type f -not -path '*/.git/*' | sort
|
||||||
|
echo '--- Release ---'; cat pages/deb/Release
|
||||||
|
echo '--- Packages ---'; cat pages/deb/Packages
|
||||||
|
gpg --verify pages/deb/InRelease
|
||||||
|
gpg --verify pages/deb/Release.gpg pages/deb/Release
|
||||||
|
gpg --verify pages/rpm/repodata/repomd.xml.asc pages/rpm/repodata/repomd.xml
|
||||||
|
|
||||||
|
# The proof that the repository works is apt reading it: the signature,
|
||||||
|
# the index, the dependencies and the program that comes out the far end.
|
||||||
|
- name: Install from the repository that was just built
|
||||||
|
if: inputs.dry_run
|
||||||
|
run: |
|
||||||
|
sudo install -d -m 0755 /etc/apt/keyrings
|
||||||
|
sudo gpg --dearmor -o /etc/apt/keyrings/middleclick-autoscroll.gpg < pages/KEY.gpg
|
||||||
|
echo "deb [signed-by=/etc/apt/keyrings/middleclick-autoscroll.gpg] file://$PWD/pages/deb ./" \
|
||||||
|
| sudo tee /etc/apt/sources.list.d/middleclick-autoscroll.list
|
||||||
|
sudo apt-get update
|
||||||
|
sudo apt-get install -y middleclick-autoscroll
|
||||||
|
middleclick-autoscroll --version
|
||||||
|
middleclick-autoscroll list
|
||||||
|
|
||||||
|
- uses: actions/upload-artifact@v7
|
||||||
|
if: inputs.dry_run
|
||||||
|
with:
|
||||||
|
name: pages
|
||||||
|
path: pages
|
||||||
|
include-hidden-files: true
|
||||||
|
|
||||||
|
- name: Push them
|
||||||
|
if: steps.key.outputs.present == 'yes' && !inputs.dry_run
|
||||||
|
env:
|
||||||
|
GH_TOKEN: ${{ github.token }}
|
||||||
|
run: |
|
||||||
|
cd pages
|
||||||
|
git config user.name "github-actions[bot]"
|
||||||
|
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
|
||||||
|
git add -A
|
||||||
|
git diff --quiet --cached && { echo "nothing changed"; exit 0; }
|
||||||
|
git commit -q -m "Publish ${{ github.ref_name }}"
|
||||||
|
git push "https://x-access-token:${GH_TOKEN}@github.com/${{ github.repository }}.git" HEAD:gh-pages
|
||||||
|
|
||||||
|
verify-dnf:
|
||||||
|
name: Install from the RPM repository
|
||||||
|
needs: publish
|
||||||
|
if: inputs.dry_run
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
container: fedora:latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/download-artifact@v8
|
||||||
|
with:
|
||||||
|
name: pages
|
||||||
|
path: pages
|
||||||
|
|
||||||
|
# A real run signs the package and the repository metadata with the one
|
||||||
|
# key from the secret. A dry run has no secret, so each job made a key of
|
||||||
|
# its own and both public halves are needed to check both signatures.
|
||||||
|
- uses: actions/download-artifact@v8
|
||||||
|
with:
|
||||||
|
name: rpm
|
||||||
|
path: signer
|
||||||
|
|
||||||
|
- name: Install from the repository that was just built
|
||||||
|
run: |
|
||||||
|
rpm --import pages/KEY.gpg
|
||||||
|
rpm --import signer/rpm-signer.asc
|
||||||
|
cat > /etc/yum.repos.d/middleclick-autoscroll.repo <<EOF
|
||||||
|
[middleclick-autoscroll]
|
||||||
|
name=middleclick-autoscroll
|
||||||
|
baseurl=file://$PWD/pages/rpm
|
||||||
|
enabled=1
|
||||||
|
gpgcheck=1
|
||||||
|
repo_gpgcheck=1
|
||||||
|
gpgkey=file://$PWD/pages/KEY.gpg
|
||||||
|
EOF
|
||||||
|
# util-linux is for runuser below; the base image does not carry it,
|
||||||
|
# and util-linux-core is not the half that has it.
|
||||||
|
dnf install -y middleclick-autoscroll util-linux
|
||||||
|
|
||||||
|
# As somebody, not as root: running it as root is refused, which is
|
||||||
|
# the point of it, and a container is root by default.
|
||||||
|
useradd -m tester
|
||||||
|
runuser -u tester -- middleclick-autoscroll --version
|
||||||
|
runuser -u tester -- middleclick-autoscroll list
|
||||||
@@ -0,0 +1,6 @@
|
|||||||
|
# build artifacts
|
||||||
|
po/*.mo
|
||||||
|
doc/*.1
|
||||||
|
|
||||||
|
# packages
|
||||||
|
dist/
|
||||||
@@ -1,29 +0,0 @@
|
|||||||
-----BEGIN PGP PUBLIC KEY BLOCK-----
|
|
||||||
|
|
||||||
mQINBGqMCO8BEAC6rNuAIigcAQpbcTaGd2iJSP2hhaFQbE4YUxwPjxsidrkEOF0c
|
|
||||||
cxQq0FTmtBkHRc8DfnPF5/oO0LtL9lokKTVRdzbvm5W2/DM4OwDu3oT/vYlT/yys
|
|
||||||
shYEIylOZHj26+Gjrn9xKoQ7A920pu0P0mt5gfU01y4FEz4moydj6SUvApTWvMUI
|
|
||||||
9TvPDwKngeulMUst6J+QftjZBZrDqj/L+fH6c+OCGU4sAOBb9nm6/7wp44byFcDV
|
|
||||||
TtEdLDlH3CQ8qW9zUN8g1c5/3Au/eHA1cYojNYzZhhhN4g4mGgYPht9CNxaCQkir
|
|
||||||
sr4EnTCqWfkgUHC2ZAQ7HTyq/uXyXY7pwlYy50SJXvxN88sZb7lRWqLby1jDvLjW
|
|
||||||
fL0Zu1gmq1UXGln+YdhS3iHDrlwfyfGNZXU5NWZubWtbe1v4CUC4Em/chwMmrk9E
|
|
||||||
34xF86AQ0PcMuvqomdNNg0eFTfPw/jU0WHLQN49SIzTcH7BFj7bCnY1g9AdmfySH
|
|
||||||
8ENPh4ZSLFOykMQChCYK359saOI+B3yqSrE9UI8UaDH638Hu7IRezvlMXBqV5g4K
|
|
||||||
9+Zes+5pIzYJuvweUUrFYrxo0RyWpxticGdqZFYeBbDRJf26oqReX8eua2L3ONL1
|
|
||||||
MnoeBZF0Vmftg/GA8MqSttCq98eErJb5+hdAgsxAR8gJYIsdniG34ira9wARAQAB
|
|
||||||
tDltaWRkbGVjbGljay1hdXRvc2Nyb2xsIHJlcG9zaXRvcnkgPGZlbGl0ZW5kb3l0
|
|
||||||
QGdtYWlsLmNvbT6JAk4EEwEKADgWIQRjg8j0Nzst6xSS4qxVo8bfKRRMeQUCaowI
|
|
||||||
7wIbAwULCQgHAgYVCgkICwIEFgIDAQIeAQIXgAAKCRBVo8bfKRRMeSBrD/0fL1Mv
|
|
||||||
pTIUixusX5sj9yvTuE6hO4XlRD1GymS4McUibFGwmS1FtLZ4REV1B37H4nMDKNJk
|
|
||||||
vl2Mr68KEWMbI/MtUKk7vgoIIG/CTcSObl2Az41xQzMXklMV+3/nV2RS4DvPIFmD
|
|
||||||
x1Lm/zDhEFTBN0Drasjx3DuvJU4k6ySKiO3JQpVpK6n5ACe3JC1rVaadf/i65e4J
|
|
||||||
qeze+Ig5qOq0Dy4ii+3ixDH7sWhVDrTuqzCwcocV+f7TrZYAHGXYkySF6slQGCpQ
|
|
||||||
Xre9ZIBTaoRNGpuBaASrVcuVbGl2SddGHfksothMarC3sCKxsDbwf+SUKLi7PjxR
|
|
||||||
sE73Kdwv5ErV+JeBkwRv+1UvrxTqrqLZvpBw3aWtg/d0HV9wyPdF8M9/tKRrt3BW
|
|
||||||
qYPY+3vmyuTMtFpiM5VSimHBzMTRrNtUo2w/V+BL+BFduZKFIa8jgrwC3QBYTmHV
|
|
||||||
VU0/7HYeHkc62CIUcj+mV4UebsydQwerXz4fZgn5UcE2OcuravPu1QiqUV240J/e
|
|
||||||
XJMpHgbGXLNrL8QE+x6e4s1irkOccehyuKUydgjTYsTzm1gyfvkM0B4fSFb9BQFF
|
|
||||||
aCrQsUYZ7Hwsu1Vj3k2u6uchsXsM6WBsa18ysnGwxUg7Klapuhwfpvcwav3VyvYR
|
|
||||||
rhgmwPGHTSHGNmREGwT7uE8Nk8tB0AGOdbbzBg==
|
|
||||||
=Yng/
|
|
||||||
-----END PGP PUBLIC KEY BLOCK-----
|
|
||||||
@@ -0,0 +1,674 @@
|
|||||||
|
GNU GENERAL PUBLIC LICENSE
|
||||||
|
Version 3, 29 June 2007
|
||||||
|
|
||||||
|
Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
|
||||||
|
Everyone is permitted to copy and distribute verbatim copies
|
||||||
|
of this license document, but changing it is not allowed.
|
||||||
|
|
||||||
|
Preamble
|
||||||
|
|
||||||
|
The GNU General Public License is a free, copyleft license for
|
||||||
|
software and other kinds of works.
|
||||||
|
|
||||||
|
The licenses for most software and other practical works are designed
|
||||||
|
to take away your freedom to share and change the works. By contrast,
|
||||||
|
the GNU General Public License is intended to guarantee your freedom to
|
||||||
|
share and change all versions of a program--to make sure it remains free
|
||||||
|
software for all its users. We, the Free Software Foundation, use the
|
||||||
|
GNU General Public License for most of our software; it applies also to
|
||||||
|
any other work released this way by its authors. You can apply it to
|
||||||
|
your programs, too.
|
||||||
|
|
||||||
|
When we speak of free software, we are referring to freedom, not
|
||||||
|
price. Our General Public Licenses are designed to make sure that you
|
||||||
|
have the freedom to distribute copies of free software (and charge for
|
||||||
|
them if you wish), that you receive source code or can get it if you
|
||||||
|
want it, that you can change the software or use pieces of it in new
|
||||||
|
free programs, and that you know you can do these things.
|
||||||
|
|
||||||
|
To protect your rights, we need to prevent others from denying you
|
||||||
|
these rights or asking you to surrender the rights. Therefore, you have
|
||||||
|
certain responsibilities if you distribute copies of the software, or if
|
||||||
|
you modify it: responsibilities to respect the freedom of others.
|
||||||
|
|
||||||
|
For example, if you distribute copies of such a program, whether
|
||||||
|
gratis or for a fee, you must pass on to the recipients the same
|
||||||
|
freedoms that you received. You must make sure that they, too, receive
|
||||||
|
or can get the source code. And you must show them these terms so they
|
||||||
|
know their rights.
|
||||||
|
|
||||||
|
Developers that use the GNU GPL protect your rights with two steps:
|
||||||
|
(1) assert copyright on the software, and (2) offer you this License
|
||||||
|
giving you legal permission to copy, distribute and/or modify it.
|
||||||
|
|
||||||
|
For the developers' and authors' protection, the GPL clearly explains
|
||||||
|
that there is no warranty for this free software. For both users' and
|
||||||
|
authors' sake, the GPL requires that modified versions be marked as
|
||||||
|
changed, so that their problems will not be attributed erroneously to
|
||||||
|
authors of previous versions.
|
||||||
|
|
||||||
|
Some devices are designed to deny users access to install or run
|
||||||
|
modified versions of the software inside them, although the manufacturer
|
||||||
|
can do so. This is fundamentally incompatible with the aim of
|
||||||
|
protecting users' freedom to change the software. The systematic
|
||||||
|
pattern of such abuse occurs in the area of products for individuals to
|
||||||
|
use, which is precisely where it is most unacceptable. Therefore, we
|
||||||
|
have designed this version of the GPL to prohibit the practice for those
|
||||||
|
products. If such problems arise substantially in other domains, we
|
||||||
|
stand ready to extend this provision to those domains in future versions
|
||||||
|
of the GPL, as needed to protect the freedom of users.
|
||||||
|
|
||||||
|
Finally, every program is threatened constantly by software patents.
|
||||||
|
States should not allow patents to restrict development and use of
|
||||||
|
software on general-purpose computers, but in those that do, we wish to
|
||||||
|
avoid the special danger that patents applied to a free program could
|
||||||
|
make it effectively proprietary. To prevent this, the GPL assures that
|
||||||
|
patents cannot be used to render the program non-free.
|
||||||
|
|
||||||
|
The precise terms and conditions for copying, distribution and
|
||||||
|
modification follow.
|
||||||
|
|
||||||
|
TERMS AND CONDITIONS
|
||||||
|
|
||||||
|
0. Definitions.
|
||||||
|
|
||||||
|
"This License" refers to version 3 of the GNU General Public License.
|
||||||
|
|
||||||
|
"Copyright" also means copyright-like laws that apply to other kinds of
|
||||||
|
works, such as semiconductor masks.
|
||||||
|
|
||||||
|
"The Program" refers to any copyrightable work licensed under this
|
||||||
|
License. Each licensee is addressed as "you". "Licensees" and
|
||||||
|
"recipients" may be individuals or organizations.
|
||||||
|
|
||||||
|
To "modify" a work means to copy from or adapt all or part of the work
|
||||||
|
in a fashion requiring copyright permission, other than the making of an
|
||||||
|
exact copy. The resulting work is called a "modified version" of the
|
||||||
|
earlier work or a work "based on" the earlier work.
|
||||||
|
|
||||||
|
A "covered work" means either the unmodified Program or a work based
|
||||||
|
on the Program.
|
||||||
|
|
||||||
|
To "propagate" a work means to do anything with it that, without
|
||||||
|
permission, would make you directly or secondarily liable for
|
||||||
|
infringement under applicable copyright law, except executing it on a
|
||||||
|
computer or modifying a private copy. Propagation includes copying,
|
||||||
|
distribution (with or without modification), making available to the
|
||||||
|
public, and in some countries other activities as well.
|
||||||
|
|
||||||
|
To "convey" a work means any kind of propagation that enables other
|
||||||
|
parties to make or receive copies. Mere interaction with a user through
|
||||||
|
a computer network, with no transfer of a copy, is not conveying.
|
||||||
|
|
||||||
|
An interactive user interface displays "Appropriate Legal Notices"
|
||||||
|
to the extent that it includes a convenient and prominently visible
|
||||||
|
feature that (1) displays an appropriate copyright notice, and (2)
|
||||||
|
tells the user that there is no warranty for the work (except to the
|
||||||
|
extent that warranties are provided), that licensees may convey the
|
||||||
|
work under this License, and how to view a copy of this License. If
|
||||||
|
the interface presents a list of user commands or options, such as a
|
||||||
|
menu, a prominent item in the list meets this criterion.
|
||||||
|
|
||||||
|
1. Source Code.
|
||||||
|
|
||||||
|
The "source code" for a work means the preferred form of the work
|
||||||
|
for making modifications to it. "Object code" means any non-source
|
||||||
|
form of a work.
|
||||||
|
|
||||||
|
A "Standard Interface" means an interface that either is an official
|
||||||
|
standard defined by a recognized standards body, or, in the case of
|
||||||
|
interfaces specified for a particular programming language, one that
|
||||||
|
is widely used among developers working in that language.
|
||||||
|
|
||||||
|
The "System Libraries" of an executable work include anything, other
|
||||||
|
than the work as a whole, that (a) is included in the normal form of
|
||||||
|
packaging a Major Component, but which is not part of that Major
|
||||||
|
Component, and (b) serves only to enable use of the work with that
|
||||||
|
Major Component, or to implement a Standard Interface for which an
|
||||||
|
implementation is available to the public in source code form. A
|
||||||
|
"Major Component", in this context, means a major essential component
|
||||||
|
(kernel, window system, and so on) of the specific operating system
|
||||||
|
(if any) on which the executable work runs, or a compiler used to
|
||||||
|
produce the work, or an object code interpreter used to run it.
|
||||||
|
|
||||||
|
The "Corresponding Source" for a work in object code form means all
|
||||||
|
the source code needed to generate, install, and (for an executable
|
||||||
|
work) run the object code and to modify the work, including scripts to
|
||||||
|
control those activities. However, it does not include the work's
|
||||||
|
System Libraries, or general-purpose tools or generally available free
|
||||||
|
programs which are used unmodified in performing those activities but
|
||||||
|
which are not part of the work. For example, Corresponding Source
|
||||||
|
includes interface definition files associated with source files for
|
||||||
|
the work, and the source code for shared libraries and dynamically
|
||||||
|
linked subprograms that the work is specifically designed to require,
|
||||||
|
such as by intimate data communication or control flow between those
|
||||||
|
subprograms and other parts of the work.
|
||||||
|
|
||||||
|
The Corresponding Source need not include anything that users
|
||||||
|
can regenerate automatically from other parts of the Corresponding
|
||||||
|
Source.
|
||||||
|
|
||||||
|
The Corresponding Source for a work in source code form is that
|
||||||
|
same work.
|
||||||
|
|
||||||
|
2. Basic Permissions.
|
||||||
|
|
||||||
|
All rights granted under this License are granted for the term of
|
||||||
|
copyright on the Program, and are irrevocable provided the stated
|
||||||
|
conditions are met. This License explicitly affirms your unlimited
|
||||||
|
permission to run the unmodified Program. The output from running a
|
||||||
|
covered work is covered by this License only if the output, given its
|
||||||
|
content, constitutes a covered work. This License acknowledges your
|
||||||
|
rights of fair use or other equivalent, as provided by copyright law.
|
||||||
|
|
||||||
|
You may make, run and propagate covered works that you do not
|
||||||
|
convey, without conditions so long as your license otherwise remains
|
||||||
|
in force. You may convey covered works to others for the sole purpose
|
||||||
|
of having them make modifications exclusively for you, or provide you
|
||||||
|
with facilities for running those works, provided that you comply with
|
||||||
|
the terms of this License in conveying all material for which you do
|
||||||
|
not control copyright. Those thus making or running the covered works
|
||||||
|
for you must do so exclusively on your behalf, under your direction
|
||||||
|
and control, on terms that prohibit them from making any copies of
|
||||||
|
your copyrighted material outside their relationship with you.
|
||||||
|
|
||||||
|
Conveying under any other circumstances is permitted solely under
|
||||||
|
the conditions stated below. Sublicensing is not allowed; section 10
|
||||||
|
makes it unnecessary.
|
||||||
|
|
||||||
|
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
|
||||||
|
|
||||||
|
No covered work shall be deemed part of an effective technological
|
||||||
|
measure under any applicable law fulfilling obligations under article
|
||||||
|
11 of the WIPO copyright treaty adopted on 20 December 1996, or
|
||||||
|
similar laws prohibiting or restricting circumvention of such
|
||||||
|
measures.
|
||||||
|
|
||||||
|
When you convey a covered work, you waive any legal power to forbid
|
||||||
|
circumvention of technological measures to the extent such circumvention
|
||||||
|
is effected by exercising rights under this License with respect to
|
||||||
|
the covered work, and you disclaim any intention to limit operation or
|
||||||
|
modification of the work as a means of enforcing, against the work's
|
||||||
|
users, your or third parties' legal rights to forbid circumvention of
|
||||||
|
technological measures.
|
||||||
|
|
||||||
|
4. Conveying Verbatim Copies.
|
||||||
|
|
||||||
|
You may convey verbatim copies of the Program's source code as you
|
||||||
|
receive it, in any medium, provided that you conspicuously and
|
||||||
|
appropriately publish on each copy an appropriate copyright notice;
|
||||||
|
keep intact all notices stating that this License and any
|
||||||
|
non-permissive terms added in accord with section 7 apply to the code;
|
||||||
|
keep intact all notices of the absence of any warranty; and give all
|
||||||
|
recipients a copy of this License along with the Program.
|
||||||
|
|
||||||
|
You may charge any price or no price for each copy that you convey,
|
||||||
|
and you may offer support or warranty protection for a fee.
|
||||||
|
|
||||||
|
5. Conveying Modified Source Versions.
|
||||||
|
|
||||||
|
You may convey a work based on the Program, or the modifications to
|
||||||
|
produce it from the Program, in the form of source code under the
|
||||||
|
terms of section 4, provided that you also meet all of these conditions:
|
||||||
|
|
||||||
|
a) The work must carry prominent notices stating that you modified
|
||||||
|
it, and giving a relevant date.
|
||||||
|
|
||||||
|
b) The work must carry prominent notices stating that it is
|
||||||
|
released under this License and any conditions added under section
|
||||||
|
7. This requirement modifies the requirement in section 4 to
|
||||||
|
"keep intact all notices".
|
||||||
|
|
||||||
|
c) You must license the entire work, as a whole, under this
|
||||||
|
License to anyone who comes into possession of a copy. This
|
||||||
|
License will therefore apply, along with any applicable section 7
|
||||||
|
additional terms, to the whole of the work, and all its parts,
|
||||||
|
regardless of how they are packaged. This License gives no
|
||||||
|
permission to license the work in any other way, but it does not
|
||||||
|
invalidate such permission if you have separately received it.
|
||||||
|
|
||||||
|
d) If the work has interactive user interfaces, each must display
|
||||||
|
Appropriate Legal Notices; however, if the Program has interactive
|
||||||
|
interfaces that do not display Appropriate Legal Notices, your
|
||||||
|
work need not make them do so.
|
||||||
|
|
||||||
|
A compilation of a covered work with other separate and independent
|
||||||
|
works, which are not by their nature extensions of the covered work,
|
||||||
|
and which are not combined with it such as to form a larger program,
|
||||||
|
in or on a volume of a storage or distribution medium, is called an
|
||||||
|
"aggregate" if the compilation and its resulting copyright are not
|
||||||
|
used to limit the access or legal rights of the compilation's users
|
||||||
|
beyond what the individual works permit. Inclusion of a covered work
|
||||||
|
in an aggregate does not cause this License to apply to the other
|
||||||
|
parts of the aggregate.
|
||||||
|
|
||||||
|
6. Conveying Non-Source Forms.
|
||||||
|
|
||||||
|
You may convey a covered work in object code form under the terms
|
||||||
|
of sections 4 and 5, provided that you also convey the
|
||||||
|
machine-readable Corresponding Source under the terms of this License,
|
||||||
|
in one of these ways:
|
||||||
|
|
||||||
|
a) Convey the object code in, or embodied in, a physical product
|
||||||
|
(including a physical distribution medium), accompanied by the
|
||||||
|
Corresponding Source fixed on a durable physical medium
|
||||||
|
customarily used for software interchange.
|
||||||
|
|
||||||
|
b) Convey the object code in, or embodied in, a physical product
|
||||||
|
(including a physical distribution medium), accompanied by a
|
||||||
|
written offer, valid for at least three years and valid for as
|
||||||
|
long as you offer spare parts or customer support for that product
|
||||||
|
model, to give anyone who possesses the object code either (1) a
|
||||||
|
copy of the Corresponding Source for all the software in the
|
||||||
|
product that is covered by this License, on a durable physical
|
||||||
|
medium customarily used for software interchange, for a price no
|
||||||
|
more than your reasonable cost of physically performing this
|
||||||
|
conveying of source, or (2) access to copy the
|
||||||
|
Corresponding Source from a network server at no charge.
|
||||||
|
|
||||||
|
c) Convey individual copies of the object code with a copy of the
|
||||||
|
written offer to provide the Corresponding Source. This
|
||||||
|
alternative is allowed only occasionally and noncommercially, and
|
||||||
|
only if you received the object code with such an offer, in accord
|
||||||
|
with subsection 6b.
|
||||||
|
|
||||||
|
d) Convey the object code by offering access from a designated
|
||||||
|
place (gratis or for a charge), and offer equivalent access to the
|
||||||
|
Corresponding Source in the same way through the same place at no
|
||||||
|
further charge. You need not require recipients to copy the
|
||||||
|
Corresponding Source along with the object code. If the place to
|
||||||
|
copy the object code is a network server, the Corresponding Source
|
||||||
|
may be on a different server (operated by you or a third party)
|
||||||
|
that supports equivalent copying facilities, provided you maintain
|
||||||
|
clear directions next to the object code saying where to find the
|
||||||
|
Corresponding Source. Regardless of what server hosts the
|
||||||
|
Corresponding Source, you remain obligated to ensure that it is
|
||||||
|
available for as long as needed to satisfy these requirements.
|
||||||
|
|
||||||
|
e) Convey the object code using peer-to-peer transmission, provided
|
||||||
|
you inform other peers where the object code and Corresponding
|
||||||
|
Source of the work are being offered to the general public at no
|
||||||
|
charge under subsection 6d.
|
||||||
|
|
||||||
|
A separable portion of the object code, whose source code is excluded
|
||||||
|
from the Corresponding Source as a System Library, need not be
|
||||||
|
included in conveying the object code work.
|
||||||
|
|
||||||
|
A "User Product" is either (1) a "consumer product", which means any
|
||||||
|
tangible personal property which is normally used for personal, family,
|
||||||
|
or household purposes, or (2) anything designed or sold for incorporation
|
||||||
|
into a dwelling. In determining whether a product is a consumer product,
|
||||||
|
doubtful cases shall be resolved in favor of coverage. For a particular
|
||||||
|
product received by a particular user, "normally used" refers to a
|
||||||
|
typical or common use of that class of product, regardless of the status
|
||||||
|
of the particular user or of the way in which the particular user
|
||||||
|
actually uses, or expects or is expected to use, the product. A product
|
||||||
|
is a consumer product regardless of whether the product has substantial
|
||||||
|
commercial, industrial or non-consumer uses, unless such uses represent
|
||||||
|
the only significant mode of use of the product.
|
||||||
|
|
||||||
|
"Installation Information" for a User Product means any methods,
|
||||||
|
procedures, authorization keys, or other information required to install
|
||||||
|
and execute modified versions of a covered work in that User Product from
|
||||||
|
a modified version of its Corresponding Source. The information must
|
||||||
|
suffice to ensure that the continued functioning of the modified object
|
||||||
|
code is in no case prevented or interfered with solely because
|
||||||
|
modification has been made.
|
||||||
|
|
||||||
|
If you convey an object code work under this section in, or with, or
|
||||||
|
specifically for use in, a User Product, and the conveying occurs as
|
||||||
|
part of a transaction in which the right of possession and use of the
|
||||||
|
User Product is transferred to the recipient in perpetuity or for a
|
||||||
|
fixed term (regardless of how the transaction is characterized), the
|
||||||
|
Corresponding Source conveyed under this section must be accompanied
|
||||||
|
by the Installation Information. But this requirement does not apply
|
||||||
|
if neither you nor any third party retains the ability to install
|
||||||
|
modified object code on the User Product (for example, the work has
|
||||||
|
been installed in ROM).
|
||||||
|
|
||||||
|
The requirement to provide Installation Information does not include a
|
||||||
|
requirement to continue to provide support service, warranty, or updates
|
||||||
|
for a work that has been modified or installed by the recipient, or for
|
||||||
|
the User Product in which it has been modified or installed. Access to a
|
||||||
|
network may be denied when the modification itself materially and
|
||||||
|
adversely affects the operation of the network or violates the rules and
|
||||||
|
protocols for communication across the network.
|
||||||
|
|
||||||
|
Corresponding Source conveyed, and Installation Information provided,
|
||||||
|
in accord with this section must be in a format that is publicly
|
||||||
|
documented (and with an implementation available to the public in
|
||||||
|
source code form), and must require no special password or key for
|
||||||
|
unpacking, reading or copying.
|
||||||
|
|
||||||
|
7. Additional Terms.
|
||||||
|
|
||||||
|
"Additional permissions" are terms that supplement the terms of this
|
||||||
|
License by making exceptions from one or more of its conditions.
|
||||||
|
Additional permissions that are applicable to the entire Program shall
|
||||||
|
be treated as though they were included in this License, to the extent
|
||||||
|
that they are valid under applicable law. If additional permissions
|
||||||
|
apply only to part of the Program, that part may be used separately
|
||||||
|
under those permissions, but the entire Program remains governed by
|
||||||
|
this License without regard to the additional permissions.
|
||||||
|
|
||||||
|
When you convey a copy of a covered work, you may at your option
|
||||||
|
remove any additional permissions from that copy, or from any part of
|
||||||
|
it. (Additional permissions may be written to require their own
|
||||||
|
removal in certain cases when you modify the work.) You may place
|
||||||
|
additional permissions on material, added by you to a covered work,
|
||||||
|
for which you have or can give appropriate copyright permission.
|
||||||
|
|
||||||
|
Notwithstanding any other provision of this License, for material you
|
||||||
|
add to a covered work, you may (if authorized by the copyright holders of
|
||||||
|
that material) supplement the terms of this License with terms:
|
||||||
|
|
||||||
|
a) Disclaiming warranty or limiting liability differently from the
|
||||||
|
terms of sections 15 and 16 of this License; or
|
||||||
|
|
||||||
|
b) Requiring preservation of specified reasonable legal notices or
|
||||||
|
author attributions in that material or in the Appropriate Legal
|
||||||
|
Notices displayed by works containing it; or
|
||||||
|
|
||||||
|
c) Prohibiting misrepresentation of the origin of that material, or
|
||||||
|
requiring that modified versions of such material be marked in
|
||||||
|
reasonable ways as different from the original version; or
|
||||||
|
|
||||||
|
d) Limiting the use for publicity purposes of names of licensors or
|
||||||
|
authors of the material; or
|
||||||
|
|
||||||
|
e) Declining to grant rights under trademark law for use of some
|
||||||
|
trade names, trademarks, or service marks; or
|
||||||
|
|
||||||
|
f) Requiring indemnification of licensors and authors of that
|
||||||
|
material by anyone who conveys the material (or modified versions of
|
||||||
|
it) with contractual assumptions of liability to the recipient, for
|
||||||
|
any liability that these contractual assumptions directly impose on
|
||||||
|
those licensors and authors.
|
||||||
|
|
||||||
|
All other non-permissive additional terms are considered "further
|
||||||
|
restrictions" within the meaning of section 10. If the Program as you
|
||||||
|
received it, or any part of it, contains a notice stating that it is
|
||||||
|
governed by this License along with a term that is a further
|
||||||
|
restriction, you may remove that term. If a license document contains
|
||||||
|
a further restriction but permits relicensing or conveying under this
|
||||||
|
License, you may add to a covered work material governed by the terms
|
||||||
|
of that license document, provided that the further restriction does
|
||||||
|
not survive such relicensing or conveying.
|
||||||
|
|
||||||
|
If you add terms to a covered work in accord with this section, you
|
||||||
|
must place, in the relevant source files, a statement of the
|
||||||
|
additional terms that apply to those files, or a notice indicating
|
||||||
|
where to find the applicable terms.
|
||||||
|
|
||||||
|
Additional terms, permissive or non-permissive, may be stated in the
|
||||||
|
form of a separately written license, or stated as exceptions;
|
||||||
|
the above requirements apply either way.
|
||||||
|
|
||||||
|
8. Termination.
|
||||||
|
|
||||||
|
You may not propagate or modify a covered work except as expressly
|
||||||
|
provided under this License. Any attempt otherwise to propagate or
|
||||||
|
modify it is void, and will automatically terminate your rights under
|
||||||
|
this License (including any patent licenses granted under the third
|
||||||
|
paragraph of section 11).
|
||||||
|
|
||||||
|
However, if you cease all violation of this License, then your
|
||||||
|
license from a particular copyright holder is reinstated (a)
|
||||||
|
provisionally, unless and until the copyright holder explicitly and
|
||||||
|
finally terminates your license, and (b) permanently, if the copyright
|
||||||
|
holder fails to notify you of the violation by some reasonable means
|
||||||
|
prior to 60 days after the cessation.
|
||||||
|
|
||||||
|
Moreover, your license from a particular copyright holder is
|
||||||
|
reinstated permanently if the copyright holder notifies you of the
|
||||||
|
violation by some reasonable means, this is the first time you have
|
||||||
|
received notice of violation of this License (for any work) from that
|
||||||
|
copyright holder, and you cure the violation prior to 30 days after
|
||||||
|
your receipt of the notice.
|
||||||
|
|
||||||
|
Termination of your rights under this section does not terminate the
|
||||||
|
licenses of parties who have received copies or rights from you under
|
||||||
|
this License. If your rights have been terminated and not permanently
|
||||||
|
reinstated, you do not qualify to receive new licenses for the same
|
||||||
|
material under section 10.
|
||||||
|
|
||||||
|
9. Acceptance Not Required for Having Copies.
|
||||||
|
|
||||||
|
You are not required to accept this License in order to receive or
|
||||||
|
run a copy of the Program. Ancillary propagation of a covered work
|
||||||
|
occurring solely as a consequence of using peer-to-peer transmission
|
||||||
|
to receive a copy likewise does not require acceptance. However,
|
||||||
|
nothing other than this License grants you permission to propagate or
|
||||||
|
modify any covered work. These actions infringe copyright if you do
|
||||||
|
not accept this License. Therefore, by modifying or propagating a
|
||||||
|
covered work, you indicate your acceptance of this License to do so.
|
||||||
|
|
||||||
|
10. Automatic Licensing of Downstream Recipients.
|
||||||
|
|
||||||
|
Each time you convey a covered work, the recipient automatically
|
||||||
|
receives a license from the original licensors, to run, modify and
|
||||||
|
propagate that work, subject to this License. You are not responsible
|
||||||
|
for enforcing compliance by third parties with this License.
|
||||||
|
|
||||||
|
An "entity transaction" is a transaction transferring control of an
|
||||||
|
organization, or substantially all assets of one, or subdividing an
|
||||||
|
organization, or merging organizations. If propagation of a covered
|
||||||
|
work results from an entity transaction, each party to that
|
||||||
|
transaction who receives a copy of the work also receives whatever
|
||||||
|
licenses to the work the party's predecessor in interest had or could
|
||||||
|
give under the previous paragraph, plus a right to possession of the
|
||||||
|
Corresponding Source of the work from the predecessor in interest, if
|
||||||
|
the predecessor has it or can get it with reasonable efforts.
|
||||||
|
|
||||||
|
You may not impose any further restrictions on the exercise of the
|
||||||
|
rights granted or affirmed under this License. For example, you may
|
||||||
|
not impose a license fee, royalty, or other charge for exercise of
|
||||||
|
rights granted under this License, and you may not initiate litigation
|
||||||
|
(including a cross-claim or counterclaim in a lawsuit) alleging that
|
||||||
|
any patent claim is infringed by making, using, selling, offering for
|
||||||
|
sale, or importing the Program or any portion of it.
|
||||||
|
|
||||||
|
11. Patents.
|
||||||
|
|
||||||
|
A "contributor" is a copyright holder who authorizes use under this
|
||||||
|
License of the Program or a work on which the Program is based. The
|
||||||
|
work thus licensed is called the contributor's "contributor version".
|
||||||
|
|
||||||
|
A contributor's "essential patent claims" are all patent claims
|
||||||
|
owned or controlled by the contributor, whether already acquired or
|
||||||
|
hereafter acquired, that would be infringed by some manner, permitted
|
||||||
|
by this License, of making, using, or selling its contributor version,
|
||||||
|
but do not include claims that would be infringed only as a
|
||||||
|
consequence of further modification of the contributor version. For
|
||||||
|
purposes of this definition, "control" includes the right to grant
|
||||||
|
patent sublicenses in a manner consistent with the requirements of
|
||||||
|
this License.
|
||||||
|
|
||||||
|
Each contributor grants you a non-exclusive, worldwide, royalty-free
|
||||||
|
patent license under the contributor's essential patent claims, to
|
||||||
|
make, use, sell, offer for sale, import and otherwise run, modify and
|
||||||
|
propagate the contents of its contributor version.
|
||||||
|
|
||||||
|
In the following three paragraphs, a "patent license" is any express
|
||||||
|
agreement or commitment, however denominated, not to enforce a patent
|
||||||
|
(such as an express permission to practice a patent or covenant not to
|
||||||
|
sue for patent infringement). To "grant" such a patent license to a
|
||||||
|
party means to make such an agreement or commitment not to enforce a
|
||||||
|
patent against the party.
|
||||||
|
|
||||||
|
If you convey a covered work, knowingly relying on a patent license,
|
||||||
|
and the Corresponding Source of the work is not available for anyone
|
||||||
|
to copy, free of charge and under the terms of this License, through a
|
||||||
|
publicly available network server or other readily accessible means,
|
||||||
|
then you must either (1) cause the Corresponding Source to be so
|
||||||
|
available, or (2) arrange to deprive yourself of the benefit of the
|
||||||
|
patent license for this particular work, or (3) arrange, in a manner
|
||||||
|
consistent with the requirements of this License, to extend the patent
|
||||||
|
license to downstream recipients. "Knowingly relying" means you have
|
||||||
|
actual knowledge that, but for the patent license, your conveying the
|
||||||
|
covered work in a country, or your recipient's use of the covered work
|
||||||
|
in a country, would infringe one or more identifiable patents in that
|
||||||
|
country that you have reason to believe are valid.
|
||||||
|
|
||||||
|
If, pursuant to or in connection with a single transaction or
|
||||||
|
arrangement, you convey, or propagate by procuring conveyance of, a
|
||||||
|
covered work, and grant a patent license to some of the parties
|
||||||
|
receiving the covered work authorizing them to use, propagate, modify
|
||||||
|
or convey a specific copy of the covered work, then the patent license
|
||||||
|
you grant is automatically extended to all recipients of the covered
|
||||||
|
work and works based on it.
|
||||||
|
|
||||||
|
A patent license is "discriminatory" if it does not include within
|
||||||
|
the scope of its coverage, prohibits the exercise of, or is
|
||||||
|
conditioned on the non-exercise of one or more of the rights that are
|
||||||
|
specifically granted under this License. You may not convey a covered
|
||||||
|
work if you are a party to an arrangement with a third party that is
|
||||||
|
in the business of distributing software, under which you make payment
|
||||||
|
to the third party based on the extent of your activity of conveying
|
||||||
|
the work, and under which the third party grants, to any of the
|
||||||
|
parties who would receive the covered work from you, a discriminatory
|
||||||
|
patent license (a) in connection with copies of the covered work
|
||||||
|
conveyed by you (or copies made from those copies), or (b) primarily
|
||||||
|
for and in connection with specific products or compilations that
|
||||||
|
contain the covered work, unless you entered into that arrangement,
|
||||||
|
or that patent license was granted, prior to 28 March 2007.
|
||||||
|
|
||||||
|
Nothing in this License shall be construed as excluding or limiting
|
||||||
|
any implied license or other defenses to infringement that may
|
||||||
|
otherwise be available to you under applicable patent law.
|
||||||
|
|
||||||
|
12. No Surrender of Others' Freedom.
|
||||||
|
|
||||||
|
If conditions are imposed on you (whether by court order, agreement or
|
||||||
|
otherwise) that contradict the conditions of this License, they do not
|
||||||
|
excuse you from the conditions of this License. If you cannot convey a
|
||||||
|
covered work so as to satisfy simultaneously your obligations under this
|
||||||
|
License and any other pertinent obligations, then as a consequence you may
|
||||||
|
not convey it at all. For example, if you agree to terms that obligate you
|
||||||
|
to collect a royalty for further conveying from those to whom you convey
|
||||||
|
the Program, the only way you could satisfy both those terms and this
|
||||||
|
License would be to refrain entirely from conveying the Program.
|
||||||
|
|
||||||
|
13. Use with the GNU Affero General Public License.
|
||||||
|
|
||||||
|
Notwithstanding any other provision of this License, you have
|
||||||
|
permission to link or combine any covered work with a work licensed
|
||||||
|
under version 3 of the GNU Affero General Public License into a single
|
||||||
|
combined work, and to convey the resulting work. The terms of this
|
||||||
|
License will continue to apply to the part which is the covered work,
|
||||||
|
but the special requirements of the GNU Affero General Public License,
|
||||||
|
section 13, concerning interaction through a network will apply to the
|
||||||
|
combination as such.
|
||||||
|
|
||||||
|
14. Revised Versions of this License.
|
||||||
|
|
||||||
|
The Free Software Foundation may publish revised and/or new versions of
|
||||||
|
the GNU General Public License from time to time. Such new versions will
|
||||||
|
be similar in spirit to the present version, but may differ in detail to
|
||||||
|
address new problems or concerns.
|
||||||
|
|
||||||
|
Each version is given a distinguishing version number. If the
|
||||||
|
Program specifies that a certain numbered version of the GNU General
|
||||||
|
Public License "or any later version" applies to it, you have the
|
||||||
|
option of following the terms and conditions either of that numbered
|
||||||
|
version or of any later version published by the Free Software
|
||||||
|
Foundation. If the Program does not specify a version number of the
|
||||||
|
GNU General Public License, you may choose any version ever published
|
||||||
|
by the Free Software Foundation.
|
||||||
|
|
||||||
|
If the Program specifies that a proxy can decide which future
|
||||||
|
versions of the GNU General Public License can be used, that proxy's
|
||||||
|
public statement of acceptance of a version permanently authorizes you
|
||||||
|
to choose that version for the Program.
|
||||||
|
|
||||||
|
Later license versions may give you additional or different
|
||||||
|
permissions. However, no additional obligations are imposed on any
|
||||||
|
author or copyright holder as a result of your choosing to follow a
|
||||||
|
later version.
|
||||||
|
|
||||||
|
15. Disclaimer of Warranty.
|
||||||
|
|
||||||
|
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
|
||||||
|
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
|
||||||
|
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
|
||||||
|
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
|
||||||
|
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||||
|
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
|
||||||
|
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
|
||||||
|
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
||||||
|
|
||||||
|
16. Limitation of Liability.
|
||||||
|
|
||||||
|
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||||
|
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
|
||||||
|
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
|
||||||
|
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
|
||||||
|
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
|
||||||
|
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
|
||||||
|
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
|
||||||
|
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
|
||||||
|
SUCH DAMAGES.
|
||||||
|
|
||||||
|
17. Interpretation of Sections 15 and 16.
|
||||||
|
|
||||||
|
If the disclaimer of warranty and limitation of liability provided
|
||||||
|
above cannot be given local legal effect according to their terms,
|
||||||
|
reviewing courts shall apply local law that most closely approximates
|
||||||
|
an absolute waiver of all civil liability in connection with the
|
||||||
|
Program, unless a warranty or assumption of liability accompanies a
|
||||||
|
copy of the Program in return for a fee.
|
||||||
|
|
||||||
|
END OF TERMS AND CONDITIONS
|
||||||
|
|
||||||
|
How to Apply These Terms to Your New Programs
|
||||||
|
|
||||||
|
If you develop a new program, and you want it to be of the greatest
|
||||||
|
possible use to the public, the best way to achieve this is to make it
|
||||||
|
free software which everyone can redistribute and change under these terms.
|
||||||
|
|
||||||
|
To do so, attach the following notices to the program. It is safest
|
||||||
|
to attach them to the start of each source file to most effectively
|
||||||
|
state the exclusion of warranty; and each file should have at least
|
||||||
|
the "copyright" line and a pointer to where the full notice is found.
|
||||||
|
|
||||||
|
<one line to give the program's name and a brief idea of what it does.>
|
||||||
|
Copyright (C) <year> <name of author>
|
||||||
|
|
||||||
|
This program is free software: you can redistribute it and/or modify
|
||||||
|
it under the terms of the GNU General Public License as published by
|
||||||
|
the Free Software Foundation, either version 3 of the License, or
|
||||||
|
(at your option) any later version.
|
||||||
|
|
||||||
|
This program is distributed in the hope that it will be useful,
|
||||||
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
GNU General Public License for more details.
|
||||||
|
|
||||||
|
You should have received a copy of the GNU General Public License
|
||||||
|
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||||
|
|
||||||
|
Also add information on how to contact you by electronic and paper mail.
|
||||||
|
|
||||||
|
If the program does terminal interaction, make it output a short
|
||||||
|
notice like this when it starts in an interactive mode:
|
||||||
|
|
||||||
|
<program> Copyright (C) <year> <name of author>
|
||||||
|
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||||
|
This is free software, and you are welcome to redistribute it
|
||||||
|
under certain conditions; type `show c' for details.
|
||||||
|
|
||||||
|
The hypothetical commands `show w' and `show c' should show the appropriate
|
||||||
|
parts of the General Public License. Of course, your program's commands
|
||||||
|
might be different; for a GUI interface, you would use an "about box".
|
||||||
|
|
||||||
|
You should also get your employer (if you work as a programmer) or school,
|
||||||
|
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
||||||
|
For more information on this, and how to apply and follow the GNU GPL, see
|
||||||
|
<https://www.gnu.org/licenses/>.
|
||||||
|
|
||||||
|
The GNU General Public License does not permit incorporating your program
|
||||||
|
into proprietary programs. If your program is a subroutine library, you
|
||||||
|
may consider it more useful to permit linking proprietary applications with
|
||||||
|
the library. If this is what you want to do, use the GNU Lesser General
|
||||||
|
Public License instead of this License. But first, please read
|
||||||
|
<https://www.gnu.org/licenses/why-not-lgpl.html>.
|
||||||
@@ -0,0 +1,133 @@
|
|||||||
|
# middleclick-autoscroll - build and install
|
||||||
|
#
|
||||||
|
# Everything here is plain shell; "building" only means compiling the gettext
|
||||||
|
# catalogs and rendering the man page. Both targets degrade to a no-op when
|
||||||
|
# msgfmt/scdoc are missing, so the tree stays usable for development without
|
||||||
|
# the build dependencies installed.
|
||||||
|
|
||||||
|
# Overridable so a packager can pass the version it is actually building
|
||||||
|
# (`make VERSION=$pkgver`). The literal below is the fallback for builds
|
||||||
|
# straight from a checkout, and is what a release tag has to carry.
|
||||||
|
VERSION ?= 1.3.0
|
||||||
|
|
||||||
|
PREFIX ?= /usr
|
||||||
|
DESTDIR ?=
|
||||||
|
BINDIR ?= $(PREFIX)/bin
|
||||||
|
DATADIR ?= $(PREFIX)/share
|
||||||
|
LIBDIR ?= $(DATADIR)/middleclick-autoscroll/lib
|
||||||
|
LOCALEDIR ?= $(DATADIR)/locale
|
||||||
|
MANDIR ?= $(DATADIR)/man
|
||||||
|
|
||||||
|
# Where systemd looks for user units. For a normal install into /usr this is
|
||||||
|
# asked of systemd itself, because the answer is not the same everywhere - a
|
||||||
|
# distribution that still keeps /lib separate from /usr/lib says so here - and
|
||||||
|
# only guessed at when there is no systemd installed to ask.
|
||||||
|
#
|
||||||
|
# A build with a prefix of its own keeps the units under that prefix instead.
|
||||||
|
# systemd searches $(PREFIX)/lib/systemd/user as well, and a file outside the
|
||||||
|
# prefix it was asked for is not this build's to place.
|
||||||
|
ifeq ($(PREFIX),/usr)
|
||||||
|
USERUNITDIR ?= $(shell pkg-config --variable=systemduserunitdir systemd 2>/dev/null || echo /usr/lib/systemd/user)
|
||||||
|
else
|
||||||
|
USERUNITDIR ?= $(PREFIX)/lib/systemd/user
|
||||||
|
endif
|
||||||
|
|
||||||
|
LINGUAS := de
|
||||||
|
MOFILES := $(patsubst %,po/%.mo,$(LINGUAS))
|
||||||
|
MANPAGE := doc/middleclick-autoscroll.1
|
||||||
|
|
||||||
|
LIBS := $(wildcard src/lib/*.sh)
|
||||||
|
|
||||||
|
MSGFMT := $(shell command -v msgfmt 2>/dev/null)
|
||||||
|
SCDOC := $(shell command -v scdoc 2>/dev/null)
|
||||||
|
|
||||||
|
.PHONY: all build install uninstall check clean version
|
||||||
|
|
||||||
|
all: build
|
||||||
|
|
||||||
|
build: $(MOFILES) $(MANPAGE)
|
||||||
|
|
||||||
|
# The one place the version is written down, for everything that has to agree
|
||||||
|
# with it: the packaging scripts, and the release workflow checking that the
|
||||||
|
# tag it was handed says the same thing.
|
||||||
|
version:
|
||||||
|
@echo $(VERSION)
|
||||||
|
|
||||||
|
po/%.mo: po/%.po
|
||||||
|
ifdef MSGFMT
|
||||||
|
$(MSGFMT) --check --output-file=$@ $<
|
||||||
|
else
|
||||||
|
@echo "msgfmt not found - skipping $@"
|
||||||
|
endif
|
||||||
|
|
||||||
|
$(MANPAGE): doc/middleclick-autoscroll.1.scd
|
||||||
|
ifdef SCDOC
|
||||||
|
$(SCDOC) < $< > $@
|
||||||
|
else
|
||||||
|
@echo "scdoc not found - skipping $@"
|
||||||
|
endif
|
||||||
|
|
||||||
|
# Syntax-check every shell file, and run shellcheck when it is available.
|
||||||
|
check:
|
||||||
|
@set -e; for f in src/middleclick-autoscroll $(LIBS); do \
|
||||||
|
bash -n "$$f" && echo "ok $$f"; \
|
||||||
|
done
|
||||||
|
@if command -v shellcheck >/dev/null 2>&1; then \
|
||||||
|
shellcheck -x -e SC1090,SC1091 src/middleclick-autoscroll $(LIBS); \
|
||||||
|
echo "ok shellcheck"; \
|
||||||
|
else \
|
||||||
|
echo "shellcheck not found - skipped"; \
|
||||||
|
fi
|
||||||
|
@if command -v desktop-file-validate >/dev/null 2>&1; then \
|
||||||
|
echo "ok desktop-file-validate (nothing to check)"; \
|
||||||
|
fi
|
||||||
|
|
||||||
|
install: build
|
||||||
|
# executable
|
||||||
|
install -Dm755 src/middleclick-autoscroll \
|
||||||
|
"$(DESTDIR)$(BINDIR)/middleclick-autoscroll"
|
||||||
|
|
||||||
|
# shell libraries
|
||||||
|
install -d "$(DESTDIR)$(LIBDIR)"
|
||||||
|
install -Dm644 -t "$(DESTDIR)$(LIBDIR)" $(LIBS)
|
||||||
|
|
||||||
|
# the version and the resolved paths are baked in at install time
|
||||||
|
sed -i -e 's|@VERSION@|$(VERSION)|g' \
|
||||||
|
-e 's|@LIBDIR@|$(LIBDIR)|g' \
|
||||||
|
-e 's|@LOCALEDIR@|$(LOCALEDIR)|g' \
|
||||||
|
"$(DESTDIR)$(BINDIR)/middleclick-autoscroll" \
|
||||||
|
"$(DESTDIR)$(LIBDIR)"/*.sh
|
||||||
|
|
||||||
|
# user units: the watcher, and the one-shot it starts
|
||||||
|
install -Dm644 res/systemd/middleclick-autoscroll.service \
|
||||||
|
"$(DESTDIR)$(USERUNITDIR)/middleclick-autoscroll.service"
|
||||||
|
install -Dm644 res/systemd/middleclick-autoscroll.path \
|
||||||
|
"$(DESTDIR)$(USERUNITDIR)/middleclick-autoscroll.path"
|
||||||
|
sed -i -e 's|@BINDIR@|$(BINDIR)|g' \
|
||||||
|
"$(DESTDIR)$(USERUNITDIR)/middleclick-autoscroll.service"
|
||||||
|
|
||||||
|
# translations
|
||||||
|
@for l in $(LINGUAS); do \
|
||||||
|
if [ -f "po/$$l.mo" ]; then \
|
||||||
|
install -Dm644 "po/$$l.mo" \
|
||||||
|
"$(DESTDIR)$(LOCALEDIR)/$$l/LC_MESSAGES/middleclick-autoscroll.mo"; \
|
||||||
|
fi; \
|
||||||
|
done
|
||||||
|
|
||||||
|
# documentation
|
||||||
|
@if [ -f $(MANPAGE) ]; then \
|
||||||
|
install -Dm644 $(MANPAGE) "$(DESTDIR)$(MANDIR)/man1/middleclick-autoscroll.1"; \
|
||||||
|
fi
|
||||||
|
install -Dm644 README.md \
|
||||||
|
"$(DESTDIR)$(DATADIR)/doc/middleclick-autoscroll/README.md"
|
||||||
|
|
||||||
|
uninstall:
|
||||||
|
rm -f "$(DESTDIR)$(BINDIR)/middleclick-autoscroll"
|
||||||
|
rm -rf "$(DESTDIR)$(DATADIR)/middleclick-autoscroll"
|
||||||
|
rm -f "$(DESTDIR)$(USERUNITDIR)/middleclick-autoscroll.service"
|
||||||
|
rm -f "$(DESTDIR)$(USERUNITDIR)/middleclick-autoscroll.path"
|
||||||
|
rm -f "$(DESTDIR)$(MANDIR)/man1/middleclick-autoscroll.1"
|
||||||
|
rm -rf "$(DESTDIR)$(DATADIR)/doc/middleclick-autoscroll"
|
||||||
|
|
||||||
|
clean:
|
||||||
|
rm -f po/*.mo $(MANPAGE)
|
||||||
@@ -0,0 +1,161 @@
|
|||||||
|
# middleclick-autoscroll
|
||||||
|
|
||||||
|
Middle-click autoscroll is a CLI for Linux that enables autoscroll in every application that supports it.
|
||||||
|
Works with browsers, Electron apps like Discord and Spotify, Steam, and anything else that runs on Chromium under the hood.
|
||||||
|
|
||||||
|
There is no app list. My tool just looks at what uses chromium under the hood and applies the necessary steps to get it working.
|
||||||
|
|
||||||
|
## How to install
|
||||||
|
|
||||||
|
**Arch**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
yay -S middleclick-autoscroll
|
||||||
|
```
|
||||||
|
|
||||||
|
**Fedora**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo curl -fsSL -o /etc/yum.repos.d/middleclick-autoscroll.repo \
|
||||||
|
https://felitendo.github.io/middleclick-autoscroll/middleclick-autoscroll.repo
|
||||||
|
sudo dnf install middleclick-autoscroll
|
||||||
|
```
|
||||||
|
|
||||||
|
**Debian**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo install -d -m 0755 /etc/apt/keyrings
|
||||||
|
curl -fsSL https://felitendo.github.io/middleclick-autoscroll/KEY.gpg \
|
||||||
|
| sudo gpg --dearmor -o /etc/apt/keyrings/middleclick-autoscroll.gpg
|
||||||
|
echo "deb [signed-by=/etc/apt/keyrings/middleclick-autoscroll.gpg] https://felitendo.github.io/middleclick-autoscroll/deb ./" \
|
||||||
|
| sudo tee /etc/apt/sources.list.d/middleclick-autoscroll.list
|
||||||
|
sudo apt update && sudo apt install middleclick-autoscroll
|
||||||
|
```
|
||||||
|
|
||||||
|
**openSUSE**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo rpm --import https://felitendo.github.io/middleclick-autoscroll/KEY.gpg
|
||||||
|
sudo zypper addrepo --gpgcheck --refresh \
|
||||||
|
https://felitendo.github.io/middleclick-autoscroll/rpm middleclick-autoscroll
|
||||||
|
sudo zypper install middleclick-autoscroll
|
||||||
|
```
|
||||||
|
|
||||||
|
## How to use
|
||||||
|
|
||||||
|
Just run `middleclick-autoscroll`. This will open the configuration TUI that looks like this:
|
||||||
|
|
||||||
|
```
|
||||||
|
Middle-Click Autoscroll
|
||||||
|
|
||||||
|
Autoscroll ON
|
||||||
|
|
||||||
|
Applications covered 11 of 13
|
||||||
|
Not identified 1 - see the applications list
|
||||||
|
Steam ON
|
||||||
|
New applications ON
|
||||||
|
Last applied 2 minutes ago
|
||||||
|
|
||||||
|
Applications pick this up the next time they are started.
|
||||||
|
|
||||||
|
[1] Turn autoscroll on or off
|
||||||
|
[2] Re-apply everything
|
||||||
|
[3] Applications
|
||||||
|
[4] Settings
|
||||||
|
[q] Quit
|
||||||
|
|
||||||
|
>
|
||||||
|
```
|
||||||
|
|
||||||
|
`[1]` is all you need for the normal case. `[3]` lists every app that was found
|
||||||
|
and what is being done with it, so you can leave a single one out or switch on
|
||||||
|
an AppImage that couldn't be identified:
|
||||||
|
|
||||||
|
```
|
||||||
|
Applications
|
||||||
|
|
||||||
|
▸ Steam on (Steam)
|
||||||
|
Chromium on (launcher)
|
||||||
|
Discord on (flag file)
|
||||||
|
Obsidian on (launcher)
|
||||||
|
Spotify on (launcher)
|
||||||
|
Slack off
|
||||||
|
Cursor cannot tell
|
||||||
|
|
||||||
|
Anything not identified is left alone until it is turned on here.
|
||||||
|
Up/Down select - Space turns one on or off - q goes back
|
||||||
|
```
|
||||||
|
|
||||||
|
`[4]` has the same switches per category - browsers, Electron and CEF apps,
|
||||||
|
Flatpaks, snaps, autostart entries, Steam, Spotify - plus a field for extra
|
||||||
|
Chromium arguments.
|
||||||
|
|
||||||
|
## How it works
|
||||||
|
|
||||||
|
Blink (the engine in Chromium, Electron, and CEF) already has autoscroll, but
|
||||||
|
it's off on Linux because middle click does primary-selection paste there. This
|
||||||
|
flag turns it on:
|
||||||
|
|
||||||
|
--enable-blink-features=MiddleClickAutoscroll
|
||||||
|
|
||||||
|
But doing that for every app is kinda bothersome and it also might break with updates.
|
||||||
|
That's why I created this small tool to automate that.
|
||||||
|
|
||||||
|
Browsers get the same thing asked for differently:
|
||||||
|
|
||||||
|
--enable-features=MiddleClickAutoscroll
|
||||||
|
|
||||||
|
Both mean the same feature - Blink generates a matching feature name for each of
|
||||||
|
its runtime flags - but the first one is on Chromium's list of flags worth
|
||||||
|
warning about, so a browser started with it shows a yellow "unsupported
|
||||||
|
command-line flag" bar over every page. The second one is not on that list, so
|
||||||
|
there's no bar. It only works from Chromium 124 on, which is why apps that
|
||||||
|
embed something older (Steam's CEF, older Electron) keep the first one - they
|
||||||
|
have no such bar to begin with. Helium, which carries the feature under its own
|
||||||
|
name, is asked for `HeliumMiddleClickAutoscroll` alongside it.
|
||||||
|
|
||||||
|
New apps are picked up by a systemd path unit that watches the
|
||||||
|
relevant directories. Without systemd, `middleclick-autoscroll apply` does the
|
||||||
|
same thing manually.
|
||||||
|
|
||||||
|
## Steam
|
||||||
|
|
||||||
|
Steam's web UI supports autoscroll but has no way to pass extra arguments to its
|
||||||
|
helper, so the program patches the script that starts it. Steam checks its own
|
||||||
|
files at every start and repairs whatever looks changed, so the patch is written
|
||||||
|
to look unchanged.
|
||||||
|
|
||||||
|
As a fallback, for the case where that isn't possible, `-noverifyfiles` goes on
|
||||||
|
everything that starts Steam: its launcher, its autostart entry, and the
|
||||||
|
shortcuts it writes for single games. That one means Steam won't auto-repair
|
||||||
|
damaged files on its own just so you're aware of that.
|
||||||
|
|
||||||
|
## Commands
|
||||||
|
|
||||||
|
| Command | |
|
||||||
|
|---|---|
|
||||||
|
| `middleclick-autoscroll` | Interactive menu |
|
||||||
|
| `… enable` | Turn on, apply, start watching |
|
||||||
|
| `… disable` | Undo everything |
|
||||||
|
| `… apply` | Apply to new apps |
|
||||||
|
| `… apply --rebuild` | Redo from scratch |
|
||||||
|
| `… status` | What's covered |
|
||||||
|
| `… list` | All apps and how they're handled |
|
||||||
|
|
||||||
|
## Building from source
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make
|
||||||
|
sudo make install
|
||||||
|
```
|
||||||
|
|
||||||
|
Optionally needs `msgfmt` (gettext) for translations and `scdoc` for the man
|
||||||
|
page. Supports `PREFIX` and `DESTDIR`. `make check` runs syntax checks and
|
||||||
|
shellcheck.
|
||||||
|
|
||||||
|
See [packaging/README.md](packaging/README.md) for release builds and repo
|
||||||
|
signing.
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
GPL-3.0-or-later.
|
||||||
@@ -1,42 +0,0 @@
|
|||||||
-----BEGIN PGP SIGNED MESSAGE-----
|
|
||||||
Hash: SHA512
|
|
||||||
|
|
||||||
Architectures: all
|
|
||||||
Codename: stable
|
|
||||||
Components: main
|
|
||||||
Date: Thu, 01 Oct 2026 07:37:48 +0000
|
|
||||||
Label: middleclick-autoscroll
|
|
||||||
Origin: middleclick-autoscroll
|
|
||||||
Suite: stable
|
|
||||||
MD5Sum:
|
|
||||||
e086be750739f244ce337dd20f2219ff 17616 Packages
|
|
||||||
ddfeec10d73ed399c5839968236ba3a8 2196 Packages.gz
|
|
||||||
6dfae049a4cc1d4f4833ab56be5882d0 166 Release
|
|
||||||
SHA1:
|
|
||||||
7018603e49b1999b84e60003e0f6b6faf1213a65 17616 Packages
|
|
||||||
24701103de4f7729e67fc69dca249b4b7bf17333 2196 Packages.gz
|
|
||||||
5c6468fe52a9c25f1c38c8bc8de2021a4d3011f5 166 Release
|
|
||||||
SHA256:
|
|
||||||
78661a5b22e2e6ad4b081f02a905ac52ef3cc14f6a47268f0aa4ef0a42e94f39 17616 Packages
|
|
||||||
bd3458e0c2d2f3f61dd6be69b18d5c1fdf9e15d17ff2b8058c281fe1e2876bec 2196 Packages.gz
|
|
||||||
f4c6c1885dfa918963661f03126287e4ef8f1763a6da0d3dc6b21bea3b65a747 166 Release
|
|
||||||
SHA512:
|
|
||||||
1a92289fc20bb3c90922d60123491517c460c28f564c0ddcd8918c31d0aae74065381b8720b44eb5c80677e4287ba310b178ee831a8cd4ae74b1fe9cc0a3abdd 17616 Packages
|
|
||||||
bc1d259f1e84841e561e5ac30e81c0d0e51ae46db57c3186603f66a896c0a20e4a3acc634fd15235166693245287de8c9cd189c4925a55f9c0bfff713bffa9fc 2196 Packages.gz
|
|
||||||
09f14beab218aaccbc1dc69fc576e9f61d28e5fe517350ea8bf064cda85c9d5a75098aa97f90673729c7f0d854c37d21c560bdc99ec9001f2319cbcaafe24279 166 Release
|
|
||||||
-----BEGIN PGP SIGNATURE-----
|
|
||||||
|
|
||||||
iQIzBAEBCgAdFiEEY4PI9Dc7LesUkuKsVaPG3ykUTHkFAmq+DcwACgkQVaPG3ykU
|
|
||||||
THlmpQ/+J/cyqBjGj0dTXZ1eAQYCxAgCZc+RGUVK6cWQLJ3+LjauZD3fI5wrjIdU
|
|
||||||
WkiLsnZZdaShtcgwmurW1y3R+Voj40szUMQgvNBtwaK+UOKigNLvO9Z+czkGC1Ai
|
|
||||||
3a7QIbgzaSioM2KUyjK2BQLyhiuxV52+B6w0Z3n+m53JQTI7FldYMOUyUIJVlPvP
|
|
||||||
rvlYSbS6oi/rrfS488F1AkrHBYVD8/EENo3yXFCWrF+fIoxNpGfhTZv2jiloWVs6
|
|
||||||
JkKasnle0QyOlS0d59tB87eS8ctAd/fiO8JjlIrkJ0QaXKaDxFJxfK7AXJdp/hgO
|
|
||||||
F+gtg5QPABENWx4REiKF2+152kuWGOUb+RlZcKsPkcxllUX96WfokPcedT08/xX7
|
|
||||||
m/ZUKTd16d+Fre4+bVkzQ1BB19hpH7blGoSFavxOWhQvW6LgKRFJP8YVFIM7X5Th
|
|
||||||
yoK82guMLRnEQ9Qv0vwVoQIvXbnRyN8cn/1qFkvgee17+GQNlIX6nD+WGBoEpj/K
|
|
||||||
jEIJqLA1jmp5QFCYnRvlwjJTfEXloaVO+0xbPS1reMxmytUswXDyJ9wg5LnAbfOm
|
|
||||||
3SmcivJfYD1Af/rVegas5AOS5Aiegrk72/1EBibHwxYLdwT25tiGpXPDZub0ufRz
|
|
||||||
kWC0GQTdr9i/vek2XPWA2e3PdVHYFozAigU2fJTUuD89uH3vcoI=
|
|
||||||
=3XTy
|
|
||||||
-----END PGP SIGNATURE-----
|
|
||||||
-360
@@ -1,360 +0,0 @@
|
|||||||
Package: middleclick-autoscroll
|
|
||||||
Version: 1.1.0
|
|
||||||
Architecture: all
|
|
||||||
Maintainer: Felitendo <felitendoyt@gmail.com>
|
|
||||||
Depends: bash (>= 4.2), coreutils, findutils, grep, sed, mawk | gawk | original-awk
|
|
||||||
Recommends: gettext-base, systemd, desktop-file-utils
|
|
||||||
Filename: ./middleclick-autoscroll_1.1.0_all.deb
|
|
||||||
Size: 35676
|
|
||||||
MD5sum: 412f7906e3bc7446d59a0fb9f324d43d
|
|
||||||
SHA1: 7a81cb1b9587f319cbe518eddf671f697114b2e1
|
|
||||||
SHA256: bb1ac805adf3d161a3b8b3c1a635a9d5b3a8f203c3ca4643e0e944f24308849c
|
|
||||||
Section: utils
|
|
||||||
Priority: optional
|
|
||||||
Homepage: https://github.com/Felitendo/middleclick-autoscroll
|
|
||||||
Description: middle-click autoscroll for Chromium-based applications
|
|
||||||
Blink - the engine inside Chromium, Electron and CEF - has had Windows-style
|
|
||||||
autoscroll for years: hold the middle mouse button, move the pointer, the page
|
|
||||||
scrolls. On Linux it is switched off, because middle click is already taken by
|
|
||||||
primary-selection paste.
|
|
||||||
.
|
|
||||||
This turns it back on for every application on the system that can do it, and
|
|
||||||
for anything installed later. There is no list of supported applications to
|
|
||||||
keep up to date: every launcher is examined, the ones running on Chromium
|
|
||||||
underneath are identified by what they ship rather than by their name, and the
|
|
||||||
argument goes wherever that particular application will actually read it.
|
|
||||||
.
|
|
||||||
Nothing outside the user's home directory is ever written to. Run
|
|
||||||
"middleclick-autoscroll disable" before removing this package, so that
|
|
||||||
everything it changed is put back.
|
|
||||||
|
|
||||||
Package: middleclick-autoscroll
|
|
||||||
Version: 1.2.0
|
|
||||||
Architecture: all
|
|
||||||
Maintainer: Felitendo <felitendoyt@gmail.com>
|
|
||||||
Depends: bash (>= 4.2), coreutils, findutils, grep, sed, mawk | gawk | original-awk
|
|
||||||
Recommends: gettext-base, systemd, desktop-file-utils
|
|
||||||
Filename: ./middleclick-autoscroll_1.2.0_all.deb
|
|
||||||
Size: 39252
|
|
||||||
MD5sum: 65bdc7e1bb274253370edaf3874f04b8
|
|
||||||
SHA1: a4067d90327ad3f17ff3ce4ee1ccd15d78e80cf7
|
|
||||||
SHA256: 3825984ca49a1faa00a3ee022115a23a48370766ef1db60533fe79eda92ad45f
|
|
||||||
Section: utils
|
|
||||||
Priority: optional
|
|
||||||
Homepage: https://github.com/Felitendo/middleclick-autoscroll
|
|
||||||
Description: middle-click autoscroll for Chromium-based applications
|
|
||||||
Blink - the engine inside Chromium, Electron and CEF - has had Windows-style
|
|
||||||
autoscroll for years: hold the middle mouse button, move the pointer, the page
|
|
||||||
scrolls. On Linux it is switched off, because middle click is already taken by
|
|
||||||
primary-selection paste.
|
|
||||||
.
|
|
||||||
This turns it back on for every application on the system that can do it, and
|
|
||||||
for anything installed later. There is no list of supported applications to
|
|
||||||
keep up to date: every launcher is examined, the ones running on Chromium
|
|
||||||
underneath are identified by what they ship rather than by their name, and the
|
|
||||||
argument goes wherever that particular application will actually read it.
|
|
||||||
.
|
|
||||||
Nothing outside the user's home directory is ever written to. Run
|
|
||||||
"middleclick-autoscroll disable" before removing this package, so that
|
|
||||||
everything it changed is put back.
|
|
||||||
|
|
||||||
Package: middleclick-autoscroll
|
|
||||||
Version: 1.3.0
|
|
||||||
Architecture: all
|
|
||||||
Maintainer: Felitendo <felitendoyt@gmail.com>
|
|
||||||
Depends: bash (>= 4.2), coreutils, findutils, grep, sed, mawk | gawk | original-awk
|
|
||||||
Recommends: gettext-base, systemd, desktop-file-utils
|
|
||||||
Filename: ./middleclick-autoscroll_1.3.0_all.deb
|
|
||||||
Size: 40756
|
|
||||||
MD5sum: 59a98a53aab891b3d09c61949e751eb9
|
|
||||||
SHA1: 53638aeff20d5882363a032fecb3a86fd2209fa4
|
|
||||||
SHA256: 846e4476e61d20949ad95cdee2d9efb950ac927b18b3926a9a78da3e72a61e04
|
|
||||||
Section: utils
|
|
||||||
Priority: optional
|
|
||||||
Homepage: https://github.com/Felitendo/middleclick-autoscroll
|
|
||||||
Description: middle-click autoscroll for Chromium-based applications
|
|
||||||
Blink - the engine inside Chromium, Electron and CEF - has had Windows-style
|
|
||||||
autoscroll for years: hold the middle mouse button, move the pointer, the page
|
|
||||||
scrolls. On Linux it is switched off, because middle click is already taken by
|
|
||||||
primary-selection paste.
|
|
||||||
.
|
|
||||||
This turns it back on for every application on the system that can do it, and
|
|
||||||
for anything installed later. There is no list of supported applications to
|
|
||||||
keep up to date: every launcher is examined, the ones running on Chromium
|
|
||||||
underneath are identified by what they ship rather than by their name, and the
|
|
||||||
argument goes wherever that particular application will actually read it.
|
|
||||||
.
|
|
||||||
Nothing outside the user's home directory is ever written to. Run
|
|
||||||
"middleclick-autoscroll disable" before removing this package, so that
|
|
||||||
everything it changed is put back.
|
|
||||||
|
|
||||||
Package: middleclick-autoscroll
|
|
||||||
Version: 1.4.0
|
|
||||||
Architecture: all
|
|
||||||
Maintainer: Felitendo <felitendoyt@gmail.com>
|
|
||||||
Depends: bash (>= 4.2), coreutils, findutils, grep, sed, mawk | gawk | original-awk
|
|
||||||
Recommends: gettext-base, systemd, desktop-file-utils
|
|
||||||
Filename: ./middleclick-autoscroll_1.4.0_all.deb
|
|
||||||
Size: 40256
|
|
||||||
MD5sum: e2d66a3b8f3d4e592671e52d0cfd0f24
|
|
||||||
SHA1: b489a7e0eb6bbbd15d84ee3592a4e398cb25c732
|
|
||||||
SHA256: f7a9f072fd3c8cbde653cd607c1ac43c8e4633b046e2156a679c09bbbaaa42dd
|
|
||||||
Section: utils
|
|
||||||
Priority: optional
|
|
||||||
Homepage: https://github.com/Felitendo/middleclick-autoscroll
|
|
||||||
Description: middle-click autoscroll for Chromium-based applications
|
|
||||||
Blink - the engine inside Chromium, Electron and CEF - has had Windows-style
|
|
||||||
autoscroll for years: hold the middle mouse button, move the pointer, the page
|
|
||||||
scrolls. On Linux it is switched off, because middle click is already taken by
|
|
||||||
primary-selection paste.
|
|
||||||
.
|
|
||||||
This turns it back on for every application on the system that can do it, and
|
|
||||||
for anything installed later. There is no list of supported applications to
|
|
||||||
keep up to date: every launcher is examined, the ones running on Chromium
|
|
||||||
underneath are identified by what they ship rather than by their name, and the
|
|
||||||
argument goes wherever that particular application will actually read it.
|
|
||||||
.
|
|
||||||
Nothing outside the user's home directory is ever written to. Run
|
|
||||||
"middleclick-autoscroll disable" before removing this package, so that
|
|
||||||
everything it changed is put back.
|
|
||||||
|
|
||||||
Package: middleclick-autoscroll
|
|
||||||
Version: 1.5.0
|
|
||||||
Architecture: all
|
|
||||||
Maintainer: Felitendo <felitendoyt@gmail.com>
|
|
||||||
Depends: bash (>= 4.2), coreutils, findutils, grep, sed, mawk | gawk | original-awk
|
|
||||||
Recommends: gettext-base, systemd, desktop-file-utils
|
|
||||||
Filename: ./middleclick-autoscroll_1.5.0_all.deb
|
|
||||||
Size: 42404
|
|
||||||
MD5sum: ae1dca8afb91a648a47a92d33445c470
|
|
||||||
SHA1: fb672f06a6b3712cfa7f94c2f35e9f5f36d7562d
|
|
||||||
SHA256: 7eeed772e8b5f50fc6f162dfa2d07d5adc03668af44d63027cfe8beadf78e180
|
|
||||||
Section: utils
|
|
||||||
Priority: optional
|
|
||||||
Homepage: https://github.com/Felitendo/middleclick-autoscroll
|
|
||||||
Description: middle-click autoscroll for Chromium-based applications
|
|
||||||
Blink - the engine inside Chromium, Electron and CEF - has had Windows-style
|
|
||||||
autoscroll for years: hold the middle mouse button, move the pointer, the page
|
|
||||||
scrolls. On Linux it is switched off, because middle click is already taken by
|
|
||||||
primary-selection paste.
|
|
||||||
.
|
|
||||||
This turns it back on for every application on the system that can do it, and
|
|
||||||
for anything installed later. There is no list of supported applications to
|
|
||||||
keep up to date: every launcher is examined, the ones running on Chromium
|
|
||||||
underneath are identified by what they ship rather than by their name, and the
|
|
||||||
argument goes wherever that particular application will actually read it.
|
|
||||||
.
|
|
||||||
Nothing outside the user's home directory is ever written to. Run
|
|
||||||
"middleclick-autoscroll disable" before removing this package, so that
|
|
||||||
everything it changed is put back.
|
|
||||||
|
|
||||||
Package: middleclick-autoscroll
|
|
||||||
Version: 1.5.1
|
|
||||||
Architecture: all
|
|
||||||
Maintainer: Felitendo <felitendoyt@gmail.com>
|
|
||||||
Depends: bash (>= 4.2), coreutils, findutils, grep, sed, mawk | gawk | original-awk
|
|
||||||
Recommends: gettext-base, systemd, desktop-file-utils
|
|
||||||
Filename: ./middleclick-autoscroll_1.5.1_all.deb
|
|
||||||
Size: 46932
|
|
||||||
MD5sum: 4cad3fe99518463a266cb0de3bba5e83
|
|
||||||
SHA1: d5923ca9e1e911ff9b19ed1c3f1511b2eff8752e
|
|
||||||
SHA256: cbe16c7d91bec102d8d1314e2245a895d065c59f281fceb65dceedd16e9c939d
|
|
||||||
Section: utils
|
|
||||||
Priority: optional
|
|
||||||
Homepage: https://github.com/Felitendo/middleclick-autoscroll
|
|
||||||
Description: middle-click autoscroll for Chromium-based applications
|
|
||||||
Blink - the engine inside Chromium, Electron and CEF - has had Windows-style
|
|
||||||
autoscroll for years: hold the middle mouse button, move the pointer, the page
|
|
||||||
scrolls. On Linux it is switched off, because middle click is already taken by
|
|
||||||
primary-selection paste.
|
|
||||||
.
|
|
||||||
This turns it back on for every application on the system that can do it, and
|
|
||||||
for anything installed later. There is no list of supported applications to
|
|
||||||
keep up to date: every launcher is examined, the ones running on Chromium
|
|
||||||
underneath are identified by what they ship rather than by their name, and the
|
|
||||||
argument goes wherever that particular application will actually read it.
|
|
||||||
.
|
|
||||||
Nothing outside the user's home directory is ever written to. Run
|
|
||||||
"middleclick-autoscroll disable" before removing this package, so that
|
|
||||||
everything it changed is put back.
|
|
||||||
|
|
||||||
Package: middleclick-autoscroll
|
|
||||||
Version: 1.5.2
|
|
||||||
Architecture: all
|
|
||||||
Maintainer: Felitendo <felitendoyt@gmail.com>
|
|
||||||
Depends: bash (>= 4.2), coreutils, findutils, grep, sed, mawk | gawk | original-awk
|
|
||||||
Recommends: gettext-base, systemd, desktop-file-utils
|
|
||||||
Filename: ./middleclick-autoscroll_1.5.2_all.deb
|
|
||||||
Size: 46556
|
|
||||||
MD5sum: 41863443b7c4cbc90a73e8423b7470c3
|
|
||||||
SHA1: 8283d073de71403a27602b6fa7e67fc4db94cfe9
|
|
||||||
SHA256: 9434c9f13980de62df08296dc8042609f7e411bb76a6d391eeb359b3fd3185f1
|
|
||||||
Section: utils
|
|
||||||
Priority: optional
|
|
||||||
Homepage: https://github.com/LoonixTools/middleclick-autoscroll
|
|
||||||
Description: middle-click autoscroll for Chromium-based applications
|
|
||||||
Blink (the engine inside Chromium, Electron and CEF) has had Windows-style
|
|
||||||
autoscroll for years: hold the middle mouse button, move the pointer, the page
|
|
||||||
scrolls. On Linux it is switched off, because middle click is already taken by
|
|
||||||
primary-selection paste.
|
|
||||||
.
|
|
||||||
This turns it back on for every application on the system that can do it, and
|
|
||||||
for anything installed later. There is no list of supported applications to
|
|
||||||
keep up to date: every launcher is examined, the ones running on Chromium
|
|
||||||
underneath are identified by what they ship rather than by their name, and the
|
|
||||||
argument goes wherever that particular application will actually read it.
|
|
||||||
.
|
|
||||||
Nothing outside the user's home directory is ever written to. Run
|
|
||||||
"middleclick-autoscroll disable" before removing this package, so that
|
|
||||||
everything it changed is put back.
|
|
||||||
|
|
||||||
Package: middleclick-autoscroll
|
|
||||||
Version: 1.5.3
|
|
||||||
Architecture: all
|
|
||||||
Maintainer: Felitendo <felitendoyt@gmail.com>
|
|
||||||
Depends: bash (>= 4.2), coreutils, findutils, grep, sed, mawk | gawk | original-awk
|
|
||||||
Recommends: gettext-base, systemd, desktop-file-utils
|
|
||||||
Filename: ./middleclick-autoscroll_1.5.3_all.deb
|
|
||||||
Size: 46984
|
|
||||||
MD5sum: f3276c3151159668d8bc84c002ed0947
|
|
||||||
SHA1: 5f022f3357f399037456e94754818d64670acf21
|
|
||||||
SHA256: 14564200e11fc2f8592ae24fd5174acf264ebb902acd0294b0624d8de50a0d8a
|
|
||||||
Section: utils
|
|
||||||
Priority: optional
|
|
||||||
Homepage: https://github.com/LoonixTools/middleclick-autoscroll
|
|
||||||
Description: middle-click autoscroll for Chromium-based applications
|
|
||||||
Blink (the engine inside Chromium, Electron and CEF) has had Windows-style
|
|
||||||
autoscroll for years: hold the middle mouse button, move the pointer, the page
|
|
||||||
scrolls. On Linux it is switched off, because middle click is already taken by
|
|
||||||
primary-selection paste.
|
|
||||||
.
|
|
||||||
This turns it back on for every application on the system that can do it, and
|
|
||||||
for anything installed later. There is no list of supported applications to
|
|
||||||
keep up to date: every launcher is examined, the ones running on Chromium
|
|
||||||
underneath are identified by what they ship rather than by their name, and the
|
|
||||||
argument goes wherever that particular application will actually read it.
|
|
||||||
.
|
|
||||||
Nothing outside the user's home directory is ever written to. Run
|
|
||||||
"middleclick-autoscroll disable" before removing this package, so that
|
|
||||||
everything it changed is put back.
|
|
||||||
|
|
||||||
Package: middleclick-autoscroll
|
|
||||||
Version: 1.5.4
|
|
||||||
Architecture: all
|
|
||||||
Maintainer: Felitendo <felitendoyt@gmail.com>
|
|
||||||
Depends: bash (>= 4.2), coreutils, findutils, grep, sed, mawk | gawk | original-awk
|
|
||||||
Recommends: gettext-base, systemd, desktop-file-utils
|
|
||||||
Filename: ./middleclick-autoscroll_1.5.4_all.deb
|
|
||||||
Size: 47100
|
|
||||||
MD5sum: 8a1f13b3e8c2da5e9b9ed8604d828ee9
|
|
||||||
SHA1: 1c4a47f8d2f371a25eab00358f04b08dc6286c38
|
|
||||||
SHA256: 4309516c39d5788ba7b554a5709bde347c6a9fe5a0dedbba7064946542df7e3d
|
|
||||||
Section: utils
|
|
||||||
Priority: optional
|
|
||||||
Homepage: https://github.com/LoonixTools/middleclick-autoscroll
|
|
||||||
Description: middle-click autoscroll for Chromium-based applications
|
|
||||||
Blink (the engine inside Chromium, Electron and CEF) has had Windows-style
|
|
||||||
autoscroll for years: hold the middle mouse button, move the pointer, the page
|
|
||||||
scrolls. On Linux it is switched off, because middle click is already taken by
|
|
||||||
primary-selection paste.
|
|
||||||
.
|
|
||||||
This turns it back on for every application on the system that can do it, and
|
|
||||||
for anything installed later. There is no list of supported applications to
|
|
||||||
keep up to date: every launcher is examined, the ones running on Chromium
|
|
||||||
underneath are identified by what they ship rather than by their name, and the
|
|
||||||
argument goes wherever that particular application will actually read it.
|
|
||||||
.
|
|
||||||
Nothing outside the user's home directory is ever written to. Run
|
|
||||||
"middleclick-autoscroll disable" before removing this package, so that
|
|
||||||
everything it changed is put back.
|
|
||||||
|
|
||||||
Package: middleclick-autoscroll
|
|
||||||
Version: 1.6.0
|
|
||||||
Architecture: all
|
|
||||||
Maintainer: Felitendo <felitendoyt@gmail.com>
|
|
||||||
Depends: bash (>= 4.2), coreutils, findutils, grep, sed, mawk | gawk | original-awk
|
|
||||||
Recommends: gettext-base, systemd, desktop-file-utils
|
|
||||||
Filename: ./middleclick-autoscroll_1.6.0_all.deb
|
|
||||||
Size: 60872
|
|
||||||
MD5sum: 33fa1bcfc00ac72d6b34d37de5f9b540
|
|
||||||
SHA1: 4f13817665c4685c4377ef4f17571d9aad22bb39
|
|
||||||
SHA256: 6fdce8ec27270f800559c1d73a13705ec5b22d08c96ca44e1635066a5dcf8815
|
|
||||||
Section: utils
|
|
||||||
Priority: optional
|
|
||||||
Homepage: https://github.com/LoonixTools/middleclick-autoscroll
|
|
||||||
Description: middle-click autoscroll for Chromium-based applications
|
|
||||||
Blink (the engine inside Chromium, Electron and CEF) has had Windows-style
|
|
||||||
autoscroll for years: hold the middle mouse button, move the pointer, the page
|
|
||||||
scrolls. On Linux it is switched off, because middle click is already taken by
|
|
||||||
primary-selection paste.
|
|
||||||
.
|
|
||||||
This turns it back on for every application on the system that can do it, and
|
|
||||||
for anything installed later. There is no list of supported applications to
|
|
||||||
keep up to date: every launcher is examined, the ones running on Chromium
|
|
||||||
underneath are identified by what they ship rather than by their name, and the
|
|
||||||
argument goes wherever that particular application will actually read it.
|
|
||||||
.
|
|
||||||
Nothing outside the user's home directory is ever written to. Run
|
|
||||||
"middleclick-autoscroll disable" before removing this package, so that
|
|
||||||
everything it changed is put back.
|
|
||||||
|
|
||||||
Package: middleclick-autoscroll
|
|
||||||
Version: 1.6.1
|
|
||||||
Architecture: all
|
|
||||||
Maintainer: Felitendo <felitendoyt@gmail.com>
|
|
||||||
Depends: bash (>= 4.2), coreutils, findutils, grep, sed, mawk | gawk | original-awk
|
|
||||||
Recommends: gettext-base, systemd, desktop-file-utils
|
|
||||||
Filename: ./middleclick-autoscroll_1.6.1_all.deb
|
|
||||||
Size: 62180
|
|
||||||
MD5sum: 1e5db5d9d1c300d2c0b512b57764e740
|
|
||||||
SHA1: 778d57f5028eda99f849104dc07b5bef681b015d
|
|
||||||
SHA256: 881b783d216cb5f15fcf9bf0751bb9af68ba74b4579fea9a02f54acff60bebcc
|
|
||||||
Section: utils
|
|
||||||
Priority: optional
|
|
||||||
Homepage: https://github.com/LoonixTools/middleclick-autoscroll
|
|
||||||
Description: middle-click autoscroll for Chromium-based applications
|
|
||||||
Blink (the engine inside Chromium, Electron and CEF) has had Windows-style
|
|
||||||
autoscroll for years: hold the middle mouse button, move the pointer, the page
|
|
||||||
scrolls. On Linux it is switched off, because middle click is already taken by
|
|
||||||
primary-selection paste.
|
|
||||||
.
|
|
||||||
This turns it back on for every application on the system that can do it, and
|
|
||||||
for anything installed later. There is no list of supported applications to
|
|
||||||
keep up to date: every launcher is examined, the ones running on Chromium
|
|
||||||
underneath are identified by what they ship rather than by their name, and the
|
|
||||||
argument goes wherever that particular application will actually read it.
|
|
||||||
.
|
|
||||||
Nothing outside the user's home directory is ever written to. Run
|
|
||||||
"middleclick-autoscroll disable" before removing this package, so that
|
|
||||||
everything it changed is put back.
|
|
||||||
|
|
||||||
Package: middleclick-autoscroll
|
|
||||||
Version: 1.7.0
|
|
||||||
Architecture: all
|
|
||||||
Maintainer: Felitendo <felitendoyt@gmail.com>
|
|
||||||
Depends: bash (>= 4.2), coreutils, findutils, grep, sed, mawk | gawk | original-awk
|
|
||||||
Recommends: gettext-base, systemd, desktop-file-utils
|
|
||||||
Filename: ./middleclick-autoscroll_1.7.0_all.deb
|
|
||||||
Size: 65424
|
|
||||||
MD5sum: c98e6cce47723c33ced8ebda2883a89e
|
|
||||||
SHA1: 876f386d53f142b482c68f8eebc8fa55589d04e3
|
|
||||||
SHA256: 9faa1b2e93598594c96eefd3a107f401cd55829e5009c7559492e18f358c8b62
|
|
||||||
Section: utils
|
|
||||||
Priority: optional
|
|
||||||
Homepage: https://github.com/LoonixTools/middleclick-autoscroll
|
|
||||||
Description: middle-click autoscroll for Chromium-based applications
|
|
||||||
Blink (the engine inside Chromium, Electron and CEF) has had Windows-style
|
|
||||||
autoscroll for years: hold the middle mouse button, move the pointer, the page
|
|
||||||
scrolls. On Linux it is switched off, because middle click is already taken by
|
|
||||||
primary-selection paste.
|
|
||||||
.
|
|
||||||
This turns it back on for every application on the system that can do it, and
|
|
||||||
for anything installed later. There is no list of supported applications to
|
|
||||||
keep up to date: every launcher is examined, the ones running on Chromium
|
|
||||||
underneath are identified by what they ship rather than by their name, and the
|
|
||||||
argument goes wherever that particular application will actually read it.
|
|
||||||
.
|
|
||||||
Nothing outside the user's home directory is ever written to. Run
|
|
||||||
"middleclick-autoscroll disable" before removing this package, so that
|
|
||||||
everything it changed is put back.
|
|
||||||
|
|
||||||
Binary file not shown.
-23
@@ -1,23 +0,0 @@
|
|||||||
Architectures: all
|
|
||||||
Codename: stable
|
|
||||||
Components: main
|
|
||||||
Date: Thu, 01 Oct 2026 07:37:48 +0000
|
|
||||||
Label: middleclick-autoscroll
|
|
||||||
Origin: middleclick-autoscroll
|
|
||||||
Suite: stable
|
|
||||||
MD5Sum:
|
|
||||||
e086be750739f244ce337dd20f2219ff 17616 Packages
|
|
||||||
ddfeec10d73ed399c5839968236ba3a8 2196 Packages.gz
|
|
||||||
6dfae049a4cc1d4f4833ab56be5882d0 166 Release
|
|
||||||
SHA1:
|
|
||||||
7018603e49b1999b84e60003e0f6b6faf1213a65 17616 Packages
|
|
||||||
24701103de4f7729e67fc69dca249b4b7bf17333 2196 Packages.gz
|
|
||||||
5c6468fe52a9c25f1c38c8bc8de2021a4d3011f5 166 Release
|
|
||||||
SHA256:
|
|
||||||
78661a5b22e2e6ad4b081f02a905ac52ef3cc14f6a47268f0aa4ef0a42e94f39 17616 Packages
|
|
||||||
bd3458e0c2d2f3f61dd6be69b18d5c1fdf9e15d17ff2b8058c281fe1e2876bec 2196 Packages.gz
|
|
||||||
f4c6c1885dfa918963661f03126287e4ef8f1763a6da0d3dc6b21bea3b65a747 166 Release
|
|
||||||
SHA512:
|
|
||||||
1a92289fc20bb3c90922d60123491517c460c28f564c0ddcd8918c31d0aae74065381b8720b44eb5c80677e4287ba310b178ee831a8cd4ae74b1fe9cc0a3abdd 17616 Packages
|
|
||||||
bc1d259f1e84841e561e5ac30e81c0d0e51ae46db57c3186603f66a896c0a20e4a3acc634fd15235166693245287de8c9cd189c4925a55f9c0bfff713bffa9fc 2196 Packages.gz
|
|
||||||
09f14beab218aaccbc1dc69fc576e9f61d28e5fe517350ea8bf064cda85c9d5a75098aa97f90673729c7f0d854c37d21c560bdc99ec9001f2319cbcaafe24279 166 Release
|
|
||||||
@@ -1,16 +0,0 @@
|
|||||||
-----BEGIN PGP SIGNATURE-----
|
|
||||||
|
|
||||||
iQIzBAABCgAdFiEEY4PI9Dc7LesUkuKsVaPG3ykUTHkFAmq+DcwACgkQVaPG3ykU
|
|
||||||
THmXfhAAtmAYOpyp/H1yYuTpKA/W2a6d8nJt/Pzyf5nLFEmlJ63OihzjVAXxV/o7
|
|
||||||
nlI9u3DIVtJDhMOZoxrJOLS+47C5RQ8l+18sYIKH64J2rja8oGMdc7LIyuqxzDTi
|
|
||||||
OGGv5aUhwlLNjlM8IhmUKH4ncBj/BEdrzpe6nc3SPqs4EdkK6FeQBJjm6SQRalRn
|
|
||||||
d0T32RRZ8NxJWpBnE+p8WrnY7SF+F25HEJ6QgRrRtEW2TIaIA78xy9SajndyZz68
|
|
||||||
bL/7HCdzbJsINvy1NXN1SxVOEohzfMrCJ7BedIhchvAel8H6F/eZthDCNz+b9k/F
|
|
||||||
K2M8zFWfIavk2MNyxU6zc/4J6zq43OMUblZm1XCpriS/hLIgoZd/oleAgAwf9C20
|
|
||||||
BIr85MyHzFhToihnAxtyuR+1dLbwDPItnh5Al6fbmboLhli6d+erUWAdLmt5lV97
|
|
||||||
SENB7dfZX5GVq2GmjlzqCEow968movFKk7whiPOw6Ng7AHQ28Cy4lfl+zKreysX+
|
|
||||||
iIrFR5ARvz/Jal/9kgTyj2izxCZCmu8rTU5fANmJGLdNHROyiiZBy795gf3s4Dwm
|
|
||||||
7X1lkiOOJSwpGahFwVACn9F6D3efkZjxlrRo08r4tQRbpgVNl1bMEArAZw6e4PwU
|
|
||||||
pf15puSyNs9XvvyDiBPaQq+r5b9v63n2HkXJWhrTB0ojTFnTS+g=
|
|
||||||
=O+oS
|
|
||||||
-----END PGP SIGNATURE-----
|
|
||||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -0,0 +1,216 @@
|
|||||||
|
middleclick-autoscroll(1)
|
||||||
|
|
||||||
|
# NAME
|
||||||
|
|
||||||
|
middleclick-autoscroll - middle-click autoscroll in every application that supports it
|
||||||
|
|
||||||
|
# SYNOPSIS
|
||||||
|
|
||||||
|
*middleclick-autoscroll* [_command_]
|
||||||
|
|
||||||
|
# DESCRIPTION
|
||||||
|
|
||||||
|
Blink, the engine inside Chromium, Electron and CEF, implements Windows-style
|
||||||
|
autoscroll: hold the middle mouse button and the page scrolls with the pointer.
|
||||||
|
On Linux it is switched off, because middle click is taken by primary-selection
|
||||||
|
paste. It can be turned back on with *--enable-blink-features=MiddleClickAutoscroll*
|
||||||
|
on the command line.
|
||||||
|
|
||||||
|
*middleclick-autoscroll* finds every Chromium-based application on the system
|
||||||
|
and puts that argument somewhere the application will actually read it, then
|
||||||
|
keeps doing so for anything installed later.
|
||||||
|
|
||||||
|
A browser is given *--enable-features=MiddleClickAutoscroll* instead. It asks
|
||||||
|
for the same feature - Blink generates a feature of that name for each of its
|
||||||
|
runtime flags - but it is not on the list of flags Chromium warns about, so the
|
||||||
|
browser does not put a bar reading "You are using an unsupported command-line
|
||||||
|
flag" above every page. That spelling only works from Chromium 124 onwards,
|
||||||
|
which is why everything else keeps the first one: an application that embeds an
|
||||||
|
older Chromium, such as Steam's CEF, has no such bar to show anyway. Helium
|
||||||
|
knows the feature under a name of its own and is asked for
|
||||||
|
*HeliumMiddleClickAutoscroll* as well; a name a browser does not know is
|
||||||
|
ignored. It works on any distribution:
|
||||||
|
which of the routes below an application takes is read off its launcher, not
|
||||||
|
assumed from where the launcher came from.
|
||||||
|
|
||||||
|
Run without a command it shows an interactive menu. Everything it can be told
|
||||||
|
is reachable from there; the configuration file behind it does not need to be
|
||||||
|
edited by hand.
|
||||||
|
|
||||||
|
Nothing outside the user's home directory is written to, and running it as root
|
||||||
|
is refused.
|
||||||
|
|
||||||
|
# COMMANDS
|
||||||
|
|
||||||
|
*enable*
|
||||||
|
Turn autoscroll on, apply it to everything installed, and start watching
|
||||||
|
for new applications.
|
||||||
|
|
||||||
|
*disable*
|
||||||
|
Turn it off and put every file that was changed back the way it was.
|
||||||
|
|
||||||
|
*apply* [*--rebuild*]
|
||||||
|
Apply to anything that has appeared since the last run. This is what the
|
||||||
|
watcher calls; running it by hand is only needed when the watcher is off.
|
||||||
|
|
||||||
|
Entries left behind by an application that has since been uninstalled are
|
||||||
|
removed here too - the entry shadowing it lives in the user's home, where
|
||||||
|
the package manager that removed the application cannot see it.
|
||||||
|
|
||||||
|
With *--rebuild* everything is taken back first and written again from
|
||||||
|
scratch. That is the repair: it does not care what looks correct already.
|
||||||
|
|
||||||
|
*status*
|
||||||
|
How many applications are covered, whether Steam is patched, and when the
|
||||||
|
last run was.
|
||||||
|
|
||||||
|
*list*
|
||||||
|
Every Chromium-based application that was found, and how each one is
|
||||||
|
handled.
|
||||||
|
|
||||||
|
*-h*, *--help*
|
||||||
|
Show a summary of the commands.
|
||||||
|
|
||||||
|
*-V*, *--version*
|
||||||
|
Show the version.
|
||||||
|
|
||||||
|
# HOW THE ARGUMENT GETS IN
|
||||||
|
|
||||||
|
Two ways, chosen per application.
|
||||||
|
|
||||||
|
*Flag file*
|
||||||
|
Where the launcher reads extra arguments from
|
||||||
|
_$XDG_CONFIG_HOME/<name>-flags.conf_. This is the preferred route: it is
|
||||||
|
the supported way to pass arguments, it survives package upgrades, and it
|
||||||
|
applies to a launch from a terminal as much as one from the menu. A
|
||||||
|
feature list that is already in the file is extended rather than
|
||||||
|
duplicated - Chromium keeps only the last occurrence of such an option, so
|
||||||
|
a second one would switch the first one off.
|
||||||
|
|
||||||
|
Arch's Electron and Chromium packages all wrap their binaries this way, and
|
||||||
|
so do a number of individual vendors' launchers elsewhere. Whether a given
|
||||||
|
launcher does is read off the launcher itself, never assumed from the
|
||||||
|
distribution: only one that really names such a file takes this route.
|
||||||
|
|
||||||
|
*Desktop entry*
|
||||||
|
For applications that ship their own binary with no wrapper, and for
|
||||||
|
everything inside a Flatpak or a snap, a copy of the desktop entry with the
|
||||||
|
argument appended is written to _~/.local/share/applications_, where it
|
||||||
|
shadows the system one. Entries that already live there - AppImages, web
|
||||||
|
app shortcuts - are edited in place, with the original kept.
|
||||||
|
|
||||||
|
This is the route everything takes on the distributions whose Chromium
|
||||||
|
wrappers keep their equivalent file under _/etc_, where it is the system's
|
||||||
|
to write and not the user's: Debian, Ubuntu, Fedora and openSUSE among
|
||||||
|
them.
|
||||||
|
|
||||||
|
A generated entry is marked *X-MCA-Generated* and an entry edited in place
|
||||||
|
*X-MCA-Patched*. The two are never confused: the first is deleted when
|
||||||
|
undoing, the second is restored from its backup. An entry with neither
|
||||||
|
marker belongs to somebody else and is left alone.
|
||||||
|
|
||||||
|
Programs that start themselves at login write their own entry into
|
||||||
|
_~/.config/autostart_ pointing straight at their binary, bypassing the menu
|
||||||
|
entry entirely. Those are patched in place as well.
|
||||||
|
|
||||||
|
Shortcuts on the desktop itself are patched in place too. Nothing in the XDG
|
||||||
|
search path looks at that folder, so a shortcut that lives only there would
|
||||||
|
otherwise be invisible - and Steam puts one there for every game somebody asks
|
||||||
|
for a shortcut to. The folder's name is translated, and the name in use is read
|
||||||
|
from _~/.config/user-dirs.dirs_ rather than guessed; the watcher is told about
|
||||||
|
it in a drop-in written when autoscroll is turned on.
|
||||||
|
|
||||||
|
# STEAM
|
||||||
|
|
||||||
|
Steam's interface is CEF and supports the feature, but Steam builds the command
|
||||||
|
line for its web helper itself. The only way in is the script that starts the
|
||||||
|
helper, inside Steam's own installation:
|
||||||
|
|
||||||
|
~/.local/share/Steam/ubuntu12_64/steamwebhelper_sniper_wrap.sh
|
||||||
|
|
||||||
|
Where that installation is depends on how Steam was installed:
|
||||||
|
_~/.local/share/Steam_ for Valve's own package and Arch's,
|
||||||
|
_~/.steam/debian-installation_ for Debian's, and the private tree of the
|
||||||
|
sandbox for the Flatpak and the snap. All of them are looked at.
|
||||||
|
|
||||||
|
Steam compares the installed files against its manifest at every start - by
|
||||||
|
size and timestamp rather than by content - and restores whatever differs. So
|
||||||
|
the patch is written to look untouched: the bytes the argument costs are taken
|
||||||
|
back out of the script's own comments and the timestamp is put back afterwards,
|
||||||
|
leaving a file exactly as long and exactly as old as Steam left it. A client
|
||||||
|
that checks its files finds nothing to repair, and the argument survives
|
||||||
|
however Steam was started - from the menu, from a game shortcut, from a
|
||||||
|
launcher like Heroic or Lutris, from a terminal.
|
||||||
|
|
||||||
|
That is what has to work, because there is no way to make every possible way of
|
||||||
|
starting Steam carry an argument. *-noverifyfiles* is the second line rather
|
||||||
|
than the first: it covers the case where the script has no comments left to pay
|
||||||
|
for the argument and the patch has to grow the file. It goes on Steam's
|
||||||
|
launcher entry, on its entry in _~/.config/autostart_, which Steam writes as
|
||||||
|
soon as it is set to run at login, and on the shortcuts Steam writes for single
|
||||||
|
games, on the desktop and in the menu alike. A game is not an application this
|
||||||
|
program has anything to offer and none of them is listed under *Applications*,
|
||||||
|
but starting one is a Steam start like any other. The trade-off of the switch
|
||||||
|
is that Steam no longer repairs a damaged installation on its own; that is why
|
||||||
|
Steam is a switch of its own in the settings.
|
||||||
|
|
||||||
|
A patch that does change the size is still held back while the client is
|
||||||
|
running: Steam puts its own copy back, the two would only undo each other, and
|
||||||
|
the helper is started once, at the start, so patching again would not help that
|
||||||
|
session anyway. It goes in at the next apply with Steam closed. A patch that
|
||||||
|
keeps the size has nothing to wait for and goes in either way.
|
||||||
|
|
||||||
|
A client update brings a new version of the script. The watcher notices and
|
||||||
|
patches it again, and the copy kept for undoing is replaced with the new
|
||||||
|
version at the same time, so undoing puts back the script Steam last shipped
|
||||||
|
rather than the one from before the update.
|
||||||
|
|
||||||
|
# SPOTIFY
|
||||||
|
|
||||||
|
The official client is CEF rather than Electron. Installed through
|
||||||
|
*spotify-launcher*, it is started by a program that builds its own command line
|
||||||
|
and has a configuration file with a slot for extra arguments; that slot is
|
||||||
|
where the flag goes. Installed as a plain package, a Flatpak or a snap, it is
|
||||||
|
an ordinary desktop entry and needs nothing special.
|
||||||
|
|
||||||
|
# WHAT CANNOT BE DETECTED
|
||||||
|
|
||||||
|
An AppImage keeps its payload in a compressed filesystem, so there is no way to
|
||||||
|
tell from the outside whether it contains Chromium. Those are listed as *cannot
|
||||||
|
tell* and left alone until they are switched on from the applications screen.
|
||||||
|
|
||||||
|
# FILES
|
||||||
|
|
||||||
|
_~/.config/middleclick-autoscroll/config_
|
||||||
|
Written by the program. Every option in it is reachable from the menu.
|
||||||
|
|
||||||
|
_~/.local/state/middleclick-autoscroll/ledger_
|
||||||
|
One line per change, so *disable* can undo exactly what was done and
|
||||||
|
nothing else.
|
||||||
|
|
||||||
|
_~/.local/state/middleclick-autoscroll/backup/_
|
||||||
|
Copies of the files that are edited in place rather than shadowed.
|
||||||
|
|
||||||
|
_~/.cache/middleclick-autoscroll/detect_
|
||||||
|
Which programs were found to be Chromium, keyed by size and modification
|
||||||
|
time. Safe to delete.
|
||||||
|
|
||||||
|
# ENVIRONMENT
|
||||||
|
|
||||||
|
*NO_COLOR*
|
||||||
|
Disables colour.
|
||||||
|
|
||||||
|
# REQUIREMENTS
|
||||||
|
|
||||||
|
Bash 4.2 or newer and GNU coreutils. The watcher needs a systemd user session;
|
||||||
|
without one everything else works and applications installed later are picked
|
||||||
|
up at the next *apply* rather than on their own.
|
||||||
|
|
||||||
|
# SEE ALSO
|
||||||
|
|
||||||
|
*systemctl*(1), *flatpak*(1), *snap*(8)
|
||||||
|
|
||||||
|
# AUTHORS
|
||||||
|
|
||||||
|
Felitendo. Source and issue tracker at
|
||||||
|
https://github.com/Felitendo/middleclick-autoscroll
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
[middleclick-autoscroll]
|
|
||||||
name=middleclick-autoscroll
|
|
||||||
baseurl=https://loonixtools.github.io/middleclick-autoscroll/rpm
|
|
||||||
enabled=1
|
|
||||||
gpgcheck=1
|
|
||||||
repo_gpgcheck=1
|
|
||||||
gpgkey=https://loonixtools.github.io/middleclick-autoscroll/KEY.gpg
|
|
||||||
@@ -0,0 +1,88 @@
|
|||||||
|
# Packaging and releases
|
||||||
|
|
||||||
|
The Makefile installs everything; these only wrap what it produced. That is
|
||||||
|
deliberate — a packaging script that lists the files again is a second
|
||||||
|
description of the layout, and two descriptions drift.
|
||||||
|
|
||||||
|
| | |
|
||||||
|
|---|---|
|
||||||
|
| `deb/control`, `deb/copyright` | metadata for the Debian binary package |
|
||||||
|
| `rpm/middleclick-autoscroll.spec` | the RPM spec |
|
||||||
|
| `build-deb.sh`, `build-rpm.sh` | build one package into `dist/` |
|
||||||
|
| `check-version.sh` | refuses a tag that disagrees with the Makefile |
|
||||||
|
| `publish-repos.sh` | regenerates the APT and RPM repositories |
|
||||||
|
| `pages/` | the landing page and the `.repo` file served from GitHub Pages |
|
||||||
|
|
||||||
|
Neither package carries a maintainer script. The units are enabled per user by
|
||||||
|
the program itself, and there is nothing to do as root at install time.
|
||||||
|
|
||||||
|
## Building one by hand
|
||||||
|
|
||||||
|
```bash
|
||||||
|
packaging/build-deb.sh # needs dpkg-dev, gettext, scdoc
|
||||||
|
packaging/build-rpm.sh # needs rpm-build, gettext, scdoc, systemd-rpm-macros
|
||||||
|
```
|
||||||
|
|
||||||
|
Both take the version from `make version` unless one is passed as the first
|
||||||
|
argument.
|
||||||
|
|
||||||
|
## Making a release
|
||||||
|
|
||||||
|
1. Bump `VERSION` in the Makefile.
|
||||||
|
2. Commit, then `git tag vX.Y.Z && git push --tags`.
|
||||||
|
|
||||||
|
The `release` workflow builds both packages in a Debian and a Fedora container,
|
||||||
|
refuses the tag if it disagrees with the Makefile, attaches the packages to a
|
||||||
|
GitHub release, and adds them to the APT and RPM repositories on the `gh-pages`
|
||||||
|
branch. Nothing else has to be done by hand.
|
||||||
|
|
||||||
|
## Trying the release path first
|
||||||
|
|
||||||
|
```bash
|
||||||
|
gh workflow run release.yml -f dry_run=true
|
||||||
|
```
|
||||||
|
|
||||||
|
Builds both packages, builds both repositories with a key generated on the
|
||||||
|
spot, checks the three signatures it wrote, and then installs the packages back
|
||||||
|
out of the repositories — apt on the runner, dnf in a Fedora container. Nothing
|
||||||
|
is pushed and no release is made. This is worth running after any change to the
|
||||||
|
packaging, because the alternative is finding out from a tag.
|
||||||
|
|
||||||
|
## Setting up the signing, once
|
||||||
|
|
||||||
|
The repositories are signed, so this needs a key. Make one that exists for
|
||||||
|
nothing else — not a personal key — and give it no passphrase: it lives as an
|
||||||
|
encrypted repository secret, and `rpmsign` cannot be handed a passphrase
|
||||||
|
unattended.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
gpg --batch --passphrase '' --quick-generate-key \
|
||||||
|
'middleclick-autoscroll repository <felitendoyt@gmail.com>' rsa4096 sign never
|
||||||
|
|
||||||
|
gpg --armor --export-secret-keys 'middleclick-autoscroll repository' \
|
||||||
|
| gh secret set GPG_PRIVATE_KEY
|
||||||
|
```
|
||||||
|
|
||||||
|
Without the secret the workflow still builds both packages and attaches them to
|
||||||
|
the release; it says so in the log and leaves the repositories alone.
|
||||||
|
|
||||||
|
## Pointing Pages at it, once — and in this order
|
||||||
|
|
||||||
|
The `gh-pages` branch does not exist until a release has put something on it,
|
||||||
|
and a branch that does not exist cannot be picked in the Pages settings. So:
|
||||||
|
|
||||||
|
1. Set the secret, above.
|
||||||
|
2. Tag a release. The workflow creates the branch and fills it.
|
||||||
|
3. *Then* set **Pages** to deploy from a branch and pick `gh-pages` at the
|
||||||
|
root.
|
||||||
|
|
||||||
|
Doing it the other way round is a wall, and leaving Pages pointed at `main`
|
||||||
|
serves the source tree at the address the install instructions name — the key
|
||||||
|
and the indexes are 404 and nothing installs.
|
||||||
|
|
||||||
|
## What users end up with
|
||||||
|
|
||||||
|
The public key is published as `KEY.gpg` beside the repositories, and the
|
||||||
|
landing page carries the setup lines for each distribution. After that, a new
|
||||||
|
version arrives with `apt upgrade`, `dnf upgrade` or `zypper up` like anything
|
||||||
|
else.
|
||||||
Executable
+50
@@ -0,0 +1,50 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
#
|
||||||
|
# Builds the binary package for Debian, Ubuntu and their derivatives into
|
||||||
|
# dist/.
|
||||||
|
#
|
||||||
|
# Everything the package contains comes out of `make install`. This only wraps
|
||||||
|
# what that produced, so there is exactly one description of where a file goes
|
||||||
|
# and it is the Makefile - a packaging script that lists the files again is a
|
||||||
|
# second description, and the two drift.
|
||||||
|
#
|
||||||
|
# Needs: make, dpkg-deb, msgfmt (gettext), scdoc.
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
here="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||||
|
version="${1:-$(make -s -C "$here" version)}"
|
||||||
|
name=middleclick-autoscroll
|
||||||
|
|
||||||
|
# A package without its man page or its translations is not a package this
|
||||||
|
# should be quietly willing to produce: the Makefile skips both when the tools
|
||||||
|
# are missing, and the result would look like a successful build.
|
||||||
|
for tool in msgfmt scdoc dpkg-deb; do
|
||||||
|
command -v "$tool" > /dev/null || { echo "$0: $tool is not installed" >&2; exit 1; }
|
||||||
|
done
|
||||||
|
|
||||||
|
root="$(mktemp -d)"
|
||||||
|
trap 'rm -rf -- "$root"' EXIT
|
||||||
|
|
||||||
|
make -C "$here" install \
|
||||||
|
DESTDIR="$root" \
|
||||||
|
PREFIX=/usr \
|
||||||
|
VERSION="$version" \
|
||||||
|
USERUNITDIR=/usr/lib/systemd/user
|
||||||
|
|
||||||
|
install -d "$root/DEBIAN"
|
||||||
|
sed "s|@VERSION@|$version|g" "$here/packaging/deb/control" > "$root/DEBIAN/control"
|
||||||
|
install -Dm644 "$here/packaging/deb/copyright" \
|
||||||
|
"$root/usr/share/doc/$name/copyright"
|
||||||
|
|
||||||
|
# Relative to the package root, and DEBIAN/ itself is not part of the contents.
|
||||||
|
# Sorted in the C locale so the file comes out the same whatever the locale of
|
||||||
|
# the machine that built it.
|
||||||
|
( cd "$root" && find . -type f ! -path './DEBIAN/*' -printf '%P\0' \
|
||||||
|
| LC_ALL=C sort -z | xargs -0 md5sum > DEBIAN/md5sums )
|
||||||
|
|
||||||
|
mkdir -p "$here/dist"
|
||||||
|
out="$here/dist/${name}_${version}_all.deb"
|
||||||
|
dpkg-deb --root-owner-group --build "$root" "$out" > /dev/null
|
||||||
|
|
||||||
|
echo "$out"
|
||||||
Executable
+39
@@ -0,0 +1,39 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
#
|
||||||
|
# Builds the binary package for Fedora, RHEL, openSUSE and their derivatives
|
||||||
|
# into dist/.
|
||||||
|
#
|
||||||
|
# The spec takes the version as a macro rather than carrying one of its own,
|
||||||
|
# for the same reason the Debian control file has a placeholder: the Makefile
|
||||||
|
# is where the version is written down.
|
||||||
|
#
|
||||||
|
# Needs: rpmbuild, make, msgfmt (gettext), scdoc, systemd-rpm-macros.
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
here="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||||
|
version="${1:-$(make -s -C "$here" version)}"
|
||||||
|
name=middleclick-autoscroll
|
||||||
|
|
||||||
|
command -v rpmbuild > /dev/null || { echo "$0: rpmbuild is not installed" >&2; exit 1; }
|
||||||
|
|
||||||
|
top="$(mktemp -d)"
|
||||||
|
trap 'rm -rf -- "$top"' EXIT
|
||||||
|
mkdir -p "$top"/{BUILD,BUILDROOT,RPMS,SOURCES,SPECS}
|
||||||
|
|
||||||
|
# The working tree as it is, not as it was committed: a package built from a
|
||||||
|
# checkout has to contain what is in that checkout.
|
||||||
|
tar czf "$top/SOURCES/$name-$version.tar.gz" \
|
||||||
|
--transform "s,^\\.,$name-$version," \
|
||||||
|
--exclude=./.git --exclude=./dist --exclude=./po/'*.mo' \
|
||||||
|
-C "$here" .
|
||||||
|
|
||||||
|
rpmbuild \
|
||||||
|
--define "_topdir $top" \
|
||||||
|
--define "_version $version" \
|
||||||
|
-bb "$here/packaging/rpm/$name.spec" > /dev/null
|
||||||
|
|
||||||
|
mkdir -p "$here/dist"
|
||||||
|
cp "$top"/RPMS/noarch/*.rpm "$here/dist/"
|
||||||
|
|
||||||
|
ls "$here/dist/$name-$version"*.rpm
|
||||||
Executable
+36
@@ -0,0 +1,36 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
#
|
||||||
|
# Refuses a release whose tag and Makefile disagree.
|
||||||
|
#
|
||||||
|
# The version is baked into the program at install time from the Makefile, and
|
||||||
|
# the packages take theirs from the same place - but the tag is what people see
|
||||||
|
# and what the release is named after. A tag that says something else produces
|
||||||
|
# a package called 1.0.4 containing a program that reports 1.0.3, and nothing
|
||||||
|
# would have complained.
|
||||||
|
#
|
||||||
|
# Anything that is not a v-tag - a run started by hand from a branch - is not a
|
||||||
|
# release and has nothing to check.
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
here="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||||
|
ref="${1:-}"
|
||||||
|
|
||||||
|
case "$ref" in
|
||||||
|
v[0-9]*) ;;
|
||||||
|
*)
|
||||||
|
echo "not a release tag (${ref:-none}) - nothing to check against"
|
||||||
|
exit 0
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
tag_version="${ref#v}"
|
||||||
|
make_version="$(make -s -C "$here" version)"
|
||||||
|
|
||||||
|
if [[ $tag_version != "$make_version" ]]; then
|
||||||
|
echo "tag $ref says $tag_version, the Makefile says $make_version" >&2
|
||||||
|
echo "Bump VERSION in the Makefile to match the tag, or retag." >&2
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo "$ref matches the Makefile"
|
||||||
@@ -0,0 +1,24 @@
|
|||||||
|
Package: middleclick-autoscroll
|
||||||
|
Version: @VERSION@
|
||||||
|
Section: utils
|
||||||
|
Priority: optional
|
||||||
|
Architecture: all
|
||||||
|
Maintainer: Felitendo <felitendoyt@gmail.com>
|
||||||
|
Depends: bash (>= 4.2), coreutils, findutils, grep, sed, mawk | gawk | original-awk
|
||||||
|
Recommends: gettext-base, systemd, desktop-file-utils
|
||||||
|
Homepage: https://github.com/Felitendo/middleclick-autoscroll
|
||||||
|
Description: middle-click autoscroll for Chromium-based applications
|
||||||
|
Blink - the engine inside Chromium, Electron and CEF - has had Windows-style
|
||||||
|
autoscroll for years: hold the middle mouse button, move the pointer, the page
|
||||||
|
scrolls. On Linux it is switched off, because middle click is already taken by
|
||||||
|
primary-selection paste.
|
||||||
|
.
|
||||||
|
This turns it back on for every application on the system that can do it, and
|
||||||
|
for anything installed later. There is no list of supported applications to
|
||||||
|
keep up to date: every launcher is examined, the ones running on Chromium
|
||||||
|
underneath are identified by what they ship rather than by their name, and the
|
||||||
|
argument goes wherever that particular application will actually read it.
|
||||||
|
.
|
||||||
|
Nothing outside the user's home directory is ever written to. Run
|
||||||
|
"middleclick-autoscroll disable" before removing this package, so that
|
||||||
|
everything it changed is put back.
|
||||||
@@ -0,0 +1,20 @@
|
|||||||
|
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
|
||||||
|
Upstream-Name: middleclick-autoscroll
|
||||||
|
Source: https://github.com/Felitendo/middleclick-autoscroll
|
||||||
|
|
||||||
|
Files: *
|
||||||
|
Copyright: 2026 Felitendo
|
||||||
|
License: GPL-3+
|
||||||
|
|
||||||
|
License: GPL-3+
|
||||||
|
This program is free software: you can redistribute it and/or modify it under
|
||||||
|
the terms of the GNU General Public License as published by the Free Software
|
||||||
|
Foundation, either version 3 of the License, or (at your option) any later
|
||||||
|
version.
|
||||||
|
.
|
||||||
|
This program is distributed in the hope that it will be useful, but WITHOUT ANY
|
||||||
|
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
|
||||||
|
PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
||||||
|
.
|
||||||
|
On Debian systems the full text of the GNU General Public License version 3 can
|
||||||
|
be found in /usr/share/common-licenses/GPL-3.
|
||||||
@@ -64,35 +64,35 @@
|
|||||||
|
|
||||||
<h1>middleclick-autoscroll</h1>
|
<h1>middleclick-autoscroll</h1>
|
||||||
<p class="lead">
|
<p class="lead">
|
||||||
Middle-click autoscroll in every Chromium-based application on the system,
|
Middle-click autoscroll — hold the middle mouse button, move the pointer, the
|
||||||
and in anything installed later: hold the middle mouse button, move the
|
page scrolls — in every Chromium-based application on the system, and in
|
||||||
pointer, and the page scrolls.
|
anything installed later.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
This page is the package repository. Set it up once and every new version
|
This page is the package repository. Set it up once and every new version
|
||||||
arrives with the rest of your system updates. The
|
arrives with the rest of your system updates. The
|
||||||
<a href="https://github.com/LoonixTools/middleclick-autoscroll">source and the
|
<a href="https://github.com/Felitendo/middleclick-autoscroll">source and the
|
||||||
documentation</a> are on GitHub.
|
documentation</a> are on GitHub.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<h2>Debian, Ubuntu, Linux Mint, Pop!_OS</h2>
|
<h2>Debian, Ubuntu, Linux Mint, Pop!_OS</h2>
|
||||||
<pre><code>sudo install -d -m 0755 /etc/apt/keyrings
|
<pre><code>sudo install -d -m 0755 /etc/apt/keyrings
|
||||||
curl -fsSL https://loonixtools.github.io/middleclick-autoscroll/KEY.gpg \
|
curl -fsSL @BASEURL@/KEY.gpg \
|
||||||
| sudo gpg --dearmor -o /etc/apt/keyrings/middleclick-autoscroll.gpg
|
| sudo gpg --dearmor -o /etc/apt/keyrings/middleclick-autoscroll.gpg
|
||||||
echo "deb [signed-by=/etc/apt/keyrings/middleclick-autoscroll.gpg] https://loonixtools.github.io/middleclick-autoscroll/deb ./" \
|
echo "deb [signed-by=/etc/apt/keyrings/middleclick-autoscroll.gpg] @BASEURL@/deb ./" \
|
||||||
| sudo tee /etc/apt/sources.list.d/middleclick-autoscroll.list
|
| sudo tee /etc/apt/sources.list.d/middleclick-autoscroll.list
|
||||||
sudo apt update
|
sudo apt update
|
||||||
sudo apt install middleclick-autoscroll</code></pre>
|
sudo apt install middleclick-autoscroll</code></pre>
|
||||||
|
|
||||||
<h2>Fedora, RHEL, CentOS Stream</h2>
|
<h2>Fedora, RHEL, CentOS Stream</h2>
|
||||||
<pre><code>sudo curl -fsSL -o /etc/yum.repos.d/middleclick-autoscroll.repo \
|
<pre><code>sudo curl -fsSL -o /etc/yum.repos.d/middleclick-autoscroll.repo \
|
||||||
https://loonixtools.github.io/middleclick-autoscroll/middleclick-autoscroll.repo
|
@BASEURL@/middleclick-autoscroll.repo
|
||||||
sudo dnf install middleclick-autoscroll</code></pre>
|
sudo dnf install middleclick-autoscroll</code></pre>
|
||||||
|
|
||||||
<h2>openSUSE</h2>
|
<h2>openSUSE</h2>
|
||||||
<pre><code>sudo rpm --import https://loonixtools.github.io/middleclick-autoscroll/KEY.gpg
|
<pre><code>sudo rpm --import @BASEURL@/KEY.gpg
|
||||||
sudo zypper addrepo --gpgcheck --refresh https://loonixtools.github.io/middleclick-autoscroll/rpm middleclick-autoscroll
|
sudo zypper addrepo --gpgcheck --refresh @BASEURL@/rpm middleclick-autoscroll
|
||||||
sudo zypper install middleclick-autoscroll</code></pre>
|
sudo zypper install middleclick-autoscroll</code></pre>
|
||||||
|
|
||||||
<h2>Arch, CachyOS, EndeavourOS, Manjaro</h2>
|
<h2>Arch, CachyOS, EndeavourOS, Manjaro</h2>
|
||||||
@@ -103,12 +103,12 @@ sudo zypper install middleclick-autoscroll</code></pre>
|
|||||||
<p>
|
<p>
|
||||||
That is the whole setup. Nothing else has to be configured and no file has to
|
That is the whole setup. Nothing else has to be configured and no file has to
|
||||||
be edited. Run <code>middleclick-autoscroll disable</code> before removing the
|
be edited. Run <code>middleclick-autoscroll disable</code> before removing the
|
||||||
package. It puts back everything that was changed.
|
package — it puts back everything that was changed.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<footer>
|
<footer>
|
||||||
GPL-3.0-or-later. Packages are signed; the public key is
|
GPL-3.0-or-later. Packages are signed; the public key is
|
||||||
<a href="https://loonixtools.github.io/middleclick-autoscroll/KEY.gpg">KEY.gpg</a>.
|
<a href="@BASEURL@/KEY.gpg">KEY.gpg</a>.
|
||||||
</footer>
|
</footer>
|
||||||
|
|
||||||
</body>
|
</body>
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
[middleclick-autoscroll]
|
||||||
|
name=middleclick-autoscroll
|
||||||
|
baseurl=@BASEURL@/rpm
|
||||||
|
enabled=1
|
||||||
|
gpgcheck=1
|
||||||
|
repo_gpgcheck=1
|
||||||
|
gpgkey=@BASEURL@/KEY.gpg
|
||||||
Executable
+88
@@ -0,0 +1,88 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
#
|
||||||
|
# Puts the packages that were just built into the APT and RPM repositories on
|
||||||
|
# the gh-pages branch, and regenerates the indexes over everything that is
|
||||||
|
# there.
|
||||||
|
#
|
||||||
|
# Old versions are kept rather than replaced. An index built over all of them
|
||||||
|
# is what lets somebody pin a version or go back to one, and it costs a few
|
||||||
|
# hundred kilobytes.
|
||||||
|
#
|
||||||
|
# Usage: publish-repos.sh <gh-pages checkout> <directory of new packages>
|
||||||
|
#
|
||||||
|
# Needs: dpkg-dev, apt-utils, createrepo-c, gpg, and a secret key already
|
||||||
|
# imported - its id is taken from the keyring.
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
pages="$(cd -- "$1" && pwd)"
|
||||||
|
incoming="$(cd -- "$2" && pwd)"
|
||||||
|
here="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||||
|
|
||||||
|
base_url="${MCA_REPO_URL:-https://felitendo.github.io/middleclick-autoscroll}"
|
||||||
|
|
||||||
|
keyid="$(gpg --list-secret-keys --with-colons | awk -F: '/^sec:/ { print $5; exit }')"
|
||||||
|
[[ -n $keyid ]] || { echo "$0: no secret key in the keyring" >&2; exit 1; }
|
||||||
|
|
||||||
|
mkdir -p "$pages/deb" "$pages/rpm"
|
||||||
|
cp -- "$incoming"/*.deb "$pages/deb/"
|
||||||
|
cp -- "$incoming"/*.rpm "$pages/rpm/"
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# APT
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# A flat repository: the packages and their index sit in one directory and the
|
||||||
|
# sources line ends in "./". There is one distribution here and it is the same
|
||||||
|
# package for all of them, so the suite and component machinery of a pool
|
||||||
|
# layout would describe nothing.
|
||||||
|
(
|
||||||
|
cd "$pages/deb"
|
||||||
|
|
||||||
|
# The old index must be gone before the new one is written: apt-ftparchive
|
||||||
|
# hashes every file in the directory, and a Release that hashes the
|
||||||
|
# previous Release is a Release that cannot be verified.
|
||||||
|
rm -f Packages Packages.gz Release Release.gpg InRelease
|
||||||
|
|
||||||
|
dpkg-scanpackages --multiversion . > Packages
|
||||||
|
gzip -9kf Packages
|
||||||
|
|
||||||
|
apt-ftparchive \
|
||||||
|
-o APT::FTPArchive::Release::Origin=middleclick-autoscroll \
|
||||||
|
-o APT::FTPArchive::Release::Label=middleclick-autoscroll \
|
||||||
|
-o APT::FTPArchive::Release::Suite=stable \
|
||||||
|
-o APT::FTPArchive::Release::Codename=stable \
|
||||||
|
-o APT::FTPArchive::Release::Architectures=all \
|
||||||
|
-o APT::FTPArchive::Release::Components=main \
|
||||||
|
release . > Release
|
||||||
|
|
||||||
|
# Both signatures: InRelease is what current apt fetches, Release.gpg is
|
||||||
|
# what an older one falls back to.
|
||||||
|
gpg --batch --yes --local-user "$keyid" --clearsign --output InRelease Release
|
||||||
|
gpg --batch --yes --local-user "$keyid" --detach-sign --armor --output Release.gpg Release
|
||||||
|
)
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# RPM
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
(
|
||||||
|
cd "$pages/rpm"
|
||||||
|
createrepo_c --quiet --update .
|
||||||
|
rm -f repodata/repomd.xml.asc
|
||||||
|
gpg --batch --yes --local-user "$keyid" --detach-sign --armor repodata/repomd.xml
|
||||||
|
)
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# The key and the landing page
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
gpg --armor --export "$keyid" > "$pages/KEY.gpg"
|
||||||
|
|
||||||
|
sed "s|@BASEURL@|$base_url|g" "$here/packaging/pages/index.html" > "$pages/index.html"
|
||||||
|
sed "s|@BASEURL@|$base_url|g" "$here/packaging/pages/middleclick-autoscroll.repo" \
|
||||||
|
> "$pages/middleclick-autoscroll.repo"
|
||||||
|
|
||||||
|
# Pages would otherwise hand the whole directory to Jekyll, which drops every
|
||||||
|
# file whose name starts with an underscore and can rewrite the rest.
|
||||||
|
touch "$pages/.nojekyll"
|
||||||
|
|
||||||
|
echo "signed with $keyid"
|
||||||
|
ls -1 "$pages/deb" "$pages/rpm"
|
||||||
@@ -0,0 +1,72 @@
|
|||||||
|
# Built with `packaging/build-rpm.sh`, which passes the version in rather than
|
||||||
|
# editing this file: the Makefile is where the version is written down, and two
|
||||||
|
# places that have to agree are one place too many.
|
||||||
|
%global upstream_version %{?_version}%{!?_version:1.0.3}
|
||||||
|
|
||||||
|
Name: middleclick-autoscroll
|
||||||
|
Version: %{upstream_version}
|
||||||
|
Release: 1%{?dist}
|
||||||
|
Summary: Middle-click autoscroll for Chromium-based applications
|
||||||
|
|
||||||
|
License: GPL-3.0-or-later
|
||||||
|
URL: https://github.com/Felitendo/middleclick-autoscroll
|
||||||
|
Source0: %{name}-%{version}.tar.gz
|
||||||
|
|
||||||
|
BuildArch: noarch
|
||||||
|
BuildRequires: make
|
||||||
|
BuildRequires: gettext
|
||||||
|
BuildRequires: scdoc
|
||||||
|
# For %{_userunitdir}, which is where the watcher's user units belong.
|
||||||
|
BuildRequires: systemd-rpm-macros
|
||||||
|
|
||||||
|
Requires: bash >= 4.2
|
||||||
|
Requires: coreutils
|
||||||
|
Requires: findutils
|
||||||
|
Requires: grep
|
||||||
|
Requires: sed
|
||||||
|
Requires: gawk
|
||||||
|
|
||||||
|
# The interface falls back to English without gettext and picks up new
|
||||||
|
# applications at the next `apply` without systemd, so neither is required.
|
||||||
|
Recommends: /usr/bin/gettext
|
||||||
|
Recommends: systemd
|
||||||
|
Recommends: desktop-file-utils
|
||||||
|
|
||||||
|
%description
|
||||||
|
Blink - the engine inside Chromium, Electron and CEF - has had Windows-style
|
||||||
|
autoscroll for years: hold the middle mouse button, move the pointer, the page
|
||||||
|
scrolls. On Linux it is switched off, because middle click is already taken by
|
||||||
|
primary-selection paste.
|
||||||
|
|
||||||
|
This turns it back on for every application on the system that can do it, and
|
||||||
|
for anything installed later. There is no list of supported applications to keep
|
||||||
|
up to date: every launcher is examined, the ones running on Chromium underneath
|
||||||
|
are identified by what they ship rather than by their name, and the argument goes
|
||||||
|
wherever that particular application will actually read it.
|
||||||
|
|
||||||
|
Nothing outside the user's home directory is ever written to. Run
|
||||||
|
"middleclick-autoscroll disable" before removing this package, so that everything
|
||||||
|
it changed is put back.
|
||||||
|
|
||||||
|
%prep
|
||||||
|
%autosetup -n %{name}-%{version}
|
||||||
|
|
||||||
|
%build
|
||||||
|
%make_build VERSION=%{upstream_version}
|
||||||
|
|
||||||
|
%install
|
||||||
|
%make_install PREFIX=%{_prefix} VERSION=%{upstream_version} \
|
||||||
|
USERUNITDIR=%{_userunitdir}
|
||||||
|
|
||||||
|
%find_lang %{name}
|
||||||
|
|
||||||
|
%files -f %{name}.lang
|
||||||
|
%license LICENSE
|
||||||
|
%doc %{_datadir}/doc/%{name}/README.md
|
||||||
|
%{_bindir}/%{name}
|
||||||
|
%{_datadir}/%{name}/
|
||||||
|
%{_userunitdir}/%{name}.path
|
||||||
|
%{_userunitdir}/%{name}.service
|
||||||
|
%{_mandir}/man1/%{name}.1*
|
||||||
|
|
||||||
|
%changelog
|
||||||
@@ -0,0 +1,241 @@
|
|||||||
|
# Translation template for middleclick-autoscroll.
|
||||||
|
# Copyright (C) 2026 Felitendo
|
||||||
|
# This file is distributed under the same license as middleclick-autoscroll.
|
||||||
|
#
|
||||||
|
msgid ""
|
||||||
|
msgstr ""
|
||||||
|
"Project-Id-Version: middleclick-autoscroll 1.0.3\n"
|
||||||
|
"Report-Msgid-Bugs-To: https://github.com/Felitendo/middleclick-autoscroll/issues\n"
|
||||||
|
"POT-Creation-Date: 2026-08-16 00:00+0200\n"
|
||||||
|
"PO-Revision-Date: 2026-08-16 00:00+0200\n"
|
||||||
|
"Last-Translator: Felitendo\n"
|
||||||
|
"Language-Team: German\n"
|
||||||
|
"Language: de\n"
|
||||||
|
"MIME-Version: 1.0\n"
|
||||||
|
"Content-Type: text/plain; charset=UTF-8\n"
|
||||||
|
"Content-Transfer-Encoding: 8bit\n"
|
||||||
|
|
||||||
|
#. Status labels
|
||||||
|
msgid "ON"
|
||||||
|
msgstr "AN"
|
||||||
|
|
||||||
|
msgid "OFF"
|
||||||
|
msgstr "AUS"
|
||||||
|
|
||||||
|
msgid "on"
|
||||||
|
msgstr "an"
|
||||||
|
|
||||||
|
msgid "off"
|
||||||
|
msgstr "aus"
|
||||||
|
|
||||||
|
msgid "(none)"
|
||||||
|
msgstr "(keine)"
|
||||||
|
|
||||||
|
msgid "flag file"
|
||||||
|
msgstr "Flag-Datei"
|
||||||
|
|
||||||
|
msgid "launcher"
|
||||||
|
msgstr "Startereintrag"
|
||||||
|
|
||||||
|
msgid "cannot tell"
|
||||||
|
msgstr "nicht erkennbar"
|
||||||
|
|
||||||
|
msgid "not patched yet"
|
||||||
|
msgstr "noch nicht gepatcht"
|
||||||
|
|
||||||
|
msgid "waiting until Steam is closed"
|
||||||
|
msgstr "wartet, bis Steam geschlossen ist"
|
||||||
|
|
||||||
|
|
||||||
|
#. Status block
|
||||||
|
msgid "Autoscroll"
|
||||||
|
msgstr "Autoscroll"
|
||||||
|
|
||||||
|
msgid "Applications covered"
|
||||||
|
msgstr "Abgedeckte Anwendungen"
|
||||||
|
|
||||||
|
msgid "%d of %d"
|
||||||
|
msgstr "%d von %d"
|
||||||
|
|
||||||
|
msgid "Not identified"
|
||||||
|
msgstr "Nicht erkannt"
|
||||||
|
|
||||||
|
msgid "%d - see the applications list"
|
||||||
|
msgstr "%d – siehe Anwendungsliste"
|
||||||
|
|
||||||
|
msgid "Steam"
|
||||||
|
msgstr "Steam"
|
||||||
|
|
||||||
|
msgid "New applications"
|
||||||
|
msgstr "Neue Anwendungen"
|
||||||
|
|
||||||
|
msgid "Last applied"
|
||||||
|
msgstr "Zuletzt angewendet"
|
||||||
|
|
||||||
|
msgid "Applications pick this up the next time they are started."
|
||||||
|
msgstr "Anwendungen übernehmen das beim nächsten Start."
|
||||||
|
|
||||||
|
|
||||||
|
#. Menu
|
||||||
|
msgid "Turn autoscroll on or off"
|
||||||
|
msgstr "Autoscroll ein- oder ausschalten"
|
||||||
|
|
||||||
|
msgid "Re-apply everything"
|
||||||
|
msgstr "Alles neu anwenden"
|
||||||
|
|
||||||
|
msgid "Applications"
|
||||||
|
msgstr "Anwendungen"
|
||||||
|
|
||||||
|
msgid "Settings"
|
||||||
|
msgstr "Einstellungen"
|
||||||
|
|
||||||
|
msgid "Quit"
|
||||||
|
msgstr "Beenden"
|
||||||
|
|
||||||
|
msgid "Press any key to continue..."
|
||||||
|
msgstr "Beliebige Taste drücken …"
|
||||||
|
|
||||||
|
|
||||||
|
#. Settings
|
||||||
|
msgid "Electron and CEF applications"
|
||||||
|
msgstr "Electron- und CEF-Anwendungen"
|
||||||
|
|
||||||
|
msgid "Chromium-based browsers"
|
||||||
|
msgstr "Chromium-basierte Browser"
|
||||||
|
|
||||||
|
msgid "Flatpak applications"
|
||||||
|
msgstr "Flatpak-Anwendungen"
|
||||||
|
|
||||||
|
msgid "Snap applications"
|
||||||
|
msgstr "Snap-Anwendungen"
|
||||||
|
|
||||||
|
msgid "Programs that start themselves at login"
|
||||||
|
msgstr "Programme, die sich beim Anmelden selbst starten"
|
||||||
|
|
||||||
|
msgid "Spotify"
|
||||||
|
msgstr "Spotify"
|
||||||
|
|
||||||
|
msgid "Apply to newly installed applications"
|
||||||
|
msgstr "Auf neu installierte Anwendungen anwenden"
|
||||||
|
|
||||||
|
msgid "Additional Chromium arguments"
|
||||||
|
msgstr "Zusätzliche Chromium-Argumente"
|
||||||
|
|
||||||
|
msgid "Up/Down select - Space or Right changes - q goes back"
|
||||||
|
msgstr "Hoch/Runter wählt – Leertaste oder Rechts ändert – q geht zurück"
|
||||||
|
|
||||||
|
msgid "Arguments separated by spaces, empty for none:"
|
||||||
|
msgstr "Argumente mit Leerzeichen getrennt, leer für keine:"
|
||||||
|
|
||||||
|
msgid "Could not save the setting."
|
||||||
|
msgstr "Einstellung konnte nicht gespeichert werden."
|
||||||
|
|
||||||
|
|
||||||
|
#. Applications screen
|
||||||
|
msgid "Looking at the installed applications..."
|
||||||
|
msgstr "Installierte Anwendungen werden durchgesehen …"
|
||||||
|
|
||||||
|
msgid "No Chromium-based applications found."
|
||||||
|
msgstr "Keine Chromium-basierten Anwendungen gefunden."
|
||||||
|
|
||||||
|
msgid "Anything not identified is left alone until it is turned on here."
|
||||||
|
msgstr "Nicht erkannte Anwendungen bleiben unangetastet, bis sie hier eingeschaltet werden."
|
||||||
|
|
||||||
|
msgid "Autoscroll is off - this is what would be covered."
|
||||||
|
msgstr "Autoscroll ist aus – das hier wäre abgedeckt."
|
||||||
|
|
||||||
|
msgid "Up/Down select - Space turns one on or off - q goes back"
|
||||||
|
msgstr "Hoch/Runter wählt – Leertaste schaltet einzeln ein oder aus – q geht zurück"
|
||||||
|
|
||||||
|
|
||||||
|
#. Results
|
||||||
|
msgid "Autoscroll is on for %d applications."
|
||||||
|
msgstr "Autoscroll ist für %d Anwendungen an."
|
||||||
|
|
||||||
|
msgid "Applications that are already running pick this up when they are restarted."
|
||||||
|
msgstr "Bereits laufende Anwendungen übernehmen das nach einem Neustart."
|
||||||
|
|
||||||
|
msgid "Steam's launcher now skips its file check, which is what keeps the change from being undone at every start."
|
||||||
|
msgstr "Steams Startereintrag überspringt jetzt die Dateiprüfung – nur so bleibt die Änderung bei jedem Start erhalten."
|
||||||
|
|
||||||
|
msgid "Could not start the watcher for newly installed applications."
|
||||||
|
msgstr "Die Überwachung neu installierter Anwendungen konnte nicht gestartet werden."
|
||||||
|
|
||||||
|
msgid "No systemd user session - newly installed applications will not be picked up on their own."
|
||||||
|
msgstr "Keine systemd-Benutzersitzung – neu installierte Anwendungen werden nicht von selbst erfasst."
|
||||||
|
|
||||||
|
msgid "Autoscroll is off and everything that was changed has been put back."
|
||||||
|
msgstr "Autoscroll ist aus, alle Änderungen wurden zurückgenommen."
|
||||||
|
|
||||||
|
msgid "Autoscroll is off. Turn it on first."
|
||||||
|
msgstr "Autoscroll ist aus. Erst einschalten."
|
||||||
|
|
||||||
|
msgid "Applied again to %d applications."
|
||||||
|
msgstr "Erneut auf %d Anwendungen angewendet."
|
||||||
|
|
||||||
|
msgid "Applied to %d applications."
|
||||||
|
msgstr "Auf %d Anwendungen angewendet."
|
||||||
|
|
||||||
|
msgid "Already applied to %d applications."
|
||||||
|
msgstr "Bereits auf %d Anwendungen angewendet."
|
||||||
|
|
||||||
|
msgid "Steam starts its interface in a way this version does not recognise; leaving it alone."
|
||||||
|
msgstr "Steam startet seine Oberfläche auf eine Art, die diese Version nicht kennt; Steam bleibt unangetastet."
|
||||||
|
|
||||||
|
msgid "Steam is running and has put its own file back; the change waits until Steam is closed."
|
||||||
|
msgstr "Steam läuft und hat seine eigene Datei wiederhergestellt; die Änderung wird nachgeholt, sobald Steam geschlossen ist."
|
||||||
|
|
||||||
|
|
||||||
|
#. Help
|
||||||
|
msgid "Usage: middleclick-autoscroll [command]"
|
||||||
|
msgstr "Aufruf: middleclick-autoscroll [Befehl]"
|
||||||
|
|
||||||
|
msgid "Commands:"
|
||||||
|
msgstr "Befehle:"
|
||||||
|
|
||||||
|
msgid "Turn autoscroll on"
|
||||||
|
msgstr "Autoscroll einschalten"
|
||||||
|
|
||||||
|
msgid "Turn it off and put everything back"
|
||||||
|
msgstr "Ausschalten und alles zurücknehmen"
|
||||||
|
|
||||||
|
msgid "Apply to anything installed since the last run"
|
||||||
|
msgstr "Auf alles anwenden, was seit dem letzten Lauf dazugekommen ist"
|
||||||
|
|
||||||
|
msgid "Take everything back and apply it again"
|
||||||
|
msgstr "Alles zurücknehmen und neu anwenden"
|
||||||
|
|
||||||
|
msgid "Show what is covered"
|
||||||
|
msgstr "Anzeigen, was abgedeckt ist"
|
||||||
|
|
||||||
|
msgid "List every application that was found"
|
||||||
|
msgstr "Alle gefundenen Anwendungen auflisten"
|
||||||
|
|
||||||
|
msgid "Show this help"
|
||||||
|
msgstr "Diese Hilfe anzeigen"
|
||||||
|
|
||||||
|
msgid "Show the version"
|
||||||
|
msgstr "Version anzeigen"
|
||||||
|
|
||||||
|
msgid "Without a command an interactive menu is shown."
|
||||||
|
msgstr "Ohne Befehl wird ein interaktives Menü angezeigt."
|
||||||
|
|
||||||
|
msgid "Unknown command: %s"
|
||||||
|
msgstr "Unbekannter Befehl: %s"
|
||||||
|
|
||||||
|
|
||||||
|
#. Time
|
||||||
|
msgid "never"
|
||||||
|
msgstr "nie"
|
||||||
|
|
||||||
|
msgid "just now"
|
||||||
|
msgstr "gerade eben"
|
||||||
|
|
||||||
|
msgid "%d minutes ago"
|
||||||
|
msgstr "vor %d Minuten"
|
||||||
|
|
||||||
|
msgid "%d hours ago"
|
||||||
|
msgstr "vor %d Stunden"
|
||||||
|
|
||||||
|
msgid "%d days ago"
|
||||||
|
msgstr "vor %d Tagen"
|
||||||
@@ -0,0 +1,241 @@
|
|||||||
|
# Translation template for middleclick-autoscroll.
|
||||||
|
# Copyright (C) 2026 Felitendo
|
||||||
|
# This file is distributed under the same license as middleclick-autoscroll.
|
||||||
|
#
|
||||||
|
msgid ""
|
||||||
|
msgstr ""
|
||||||
|
"Project-Id-Version: middleclick-autoscroll 1.0.3\n"
|
||||||
|
"Report-Msgid-Bugs-To: https://github.com/Felitendo/middleclick-autoscroll/issues\n"
|
||||||
|
"POT-Creation-Date: 2026-08-16 00:00+0200\n"
|
||||||
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||||||
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||||
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||||||
|
"Language: \n"
|
||||||
|
"MIME-Version: 1.0\n"
|
||||||
|
"Content-Type: text/plain; charset=UTF-8\n"
|
||||||
|
"Content-Transfer-Encoding: 8bit\n"
|
||||||
|
|
||||||
|
#. Status labels
|
||||||
|
msgid "ON"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "OFF"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "on"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "off"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "(none)"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "flag file"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "launcher"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "cannot tell"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "not patched yet"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "waiting until Steam is closed"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
|
||||||
|
#. Status block
|
||||||
|
msgid "Autoscroll"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Applications covered"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "%d of %d"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Not identified"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "%d - see the applications list"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Steam"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "New applications"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Last applied"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Applications pick this up the next time they are started."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
|
||||||
|
#. Menu
|
||||||
|
msgid "Turn autoscroll on or off"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Re-apply everything"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Applications"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Settings"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Quit"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Press any key to continue..."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
|
||||||
|
#. Settings
|
||||||
|
msgid "Electron and CEF applications"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Chromium-based browsers"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Flatpak applications"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Snap applications"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Programs that start themselves at login"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Spotify"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Apply to newly installed applications"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Additional Chromium arguments"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Up/Down select - Space or Right changes - q goes back"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Arguments separated by spaces, empty for none:"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Could not save the setting."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
|
||||||
|
#. Applications screen
|
||||||
|
msgid "Looking at the installed applications..."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "No Chromium-based applications found."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Anything not identified is left alone until it is turned on here."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Autoscroll is off - this is what would be covered."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Up/Down select - Space turns one on or off - q goes back"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
|
||||||
|
#. Results
|
||||||
|
msgid "Autoscroll is on for %d applications."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Applications that are already running pick this up when they are restarted."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Steam's launcher now skips its file check, which is what keeps the change from being undone at every start."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Could not start the watcher for newly installed applications."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "No systemd user session - newly installed applications will not be picked up on their own."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Autoscroll is off and everything that was changed has been put back."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Autoscroll is off. Turn it on first."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Applied again to %d applications."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Applied to %d applications."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Already applied to %d applications."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Steam starts its interface in a way this version does not recognise; leaving it alone."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Steam is running and has put its own file back; the change waits until Steam is closed."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
|
||||||
|
#. Help
|
||||||
|
msgid "Usage: middleclick-autoscroll [command]"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Commands:"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Turn autoscroll on"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Turn it off and put everything back"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Apply to anything installed since the last run"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Take everything back and apply it again"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Show what is covered"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "List every application that was found"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Show this help"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Show the version"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Without a command an interactive menu is shown."
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "Unknown command: %s"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
|
||||||
|
#. Time
|
||||||
|
msgid "never"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "just now"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "%d minutes ago"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "%d hours ago"
|
||||||
|
msgstr ""
|
||||||
|
|
||||||
|
msgid "%d days ago"
|
||||||
|
msgstr ""
|
||||||
@@ -0,0 +1,43 @@
|
|||||||
|
[Unit]
|
||||||
|
Description=Watch for newly installed Chromium-based applications
|
||||||
|
Documentation=man:middleclick-autoscroll(1)
|
||||||
|
|
||||||
|
[Path]
|
||||||
|
# Every way an application can turn up: a package, a Flatpak, a snap, something
|
||||||
|
# installed by hand. Watching where the launchers land means there is no hook
|
||||||
|
# to write per package manager - pacman, apt, dnf, zypper, flatpak, snapd and
|
||||||
|
# an AppImage manager all end up here.
|
||||||
|
#
|
||||||
|
# A directory that does not exist on this system costs nothing: systemd watches
|
||||||
|
# the nearest parent that does and picks the path up when it appears.
|
||||||
|
PathModified=/usr/share/applications
|
||||||
|
PathModified=/usr/local/share/applications
|
||||||
|
PathModified=%h/.local/share/applications
|
||||||
|
PathModified=%h/.config/autostart
|
||||||
|
PathModified=/var/lib/flatpak/exports/share/applications
|
||||||
|
PathModified=%h/.local/share/flatpak/exports/share/applications
|
||||||
|
PathModified=/var/lib/snapd/desktop/applications
|
||||||
|
|
||||||
|
# NixOS and Guix build the search path out of profiles rather than /usr.
|
||||||
|
PathModified=/run/current-system/sw/share/applications
|
||||||
|
PathModified=%h/.nix-profile/share/applications
|
||||||
|
PathModified=%h/.guix-profile/share/applications
|
||||||
|
|
||||||
|
# The desktop folder is watched too - Steam writes a shortcut there for every
|
||||||
|
# game somebody asks for one, and starting a game is a Steam start - but its
|
||||||
|
# name is translated and cannot be written down here. `enable` adds it in a
|
||||||
|
# drop-in, from the name this system uses.
|
||||||
|
|
||||||
|
# Steam replaces the script that starts its interface on every client update,
|
||||||
|
# which takes the patch with it. Where that installation lives depends on how
|
||||||
|
# Steam was installed.
|
||||||
|
PathChanged=%h/.local/share/Steam/ubuntu12_64/steamwebhelper_sniper_wrap.sh
|
||||||
|
PathChanged=%h/.steam/debian-installation/ubuntu12_64/steamwebhelper_sniper_wrap.sh
|
||||||
|
PathChanged=%h/.var/app/com.valvesoftware.Steam/.local/share/Steam/ubuntu12_64/steamwebhelper_sniper_wrap.sh
|
||||||
|
PathChanged=%h/.var/app/com.valvesoftware.Steam/data/Steam/ubuntu12_64/steamwebhelper_sniper_wrap.sh
|
||||||
|
PathChanged=%h/snap/steam/common/.local/share/Steam/ubuntu12_64/steamwebhelper_sniper_wrap.sh
|
||||||
|
|
||||||
|
Unit=middleclick-autoscroll.service
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=default.target
|
||||||
@@ -0,0 +1,16 @@
|
|||||||
|
[Unit]
|
||||||
|
Description=Apply middle-click autoscroll to Chromium-based applications
|
||||||
|
Documentation=man:middleclick-autoscroll(1)
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
Type=oneshot
|
||||||
|
ExecStart=@BINDIR@/middleclick-autoscroll apply --quiet
|
||||||
|
# Scanning binaries for their engine is the slow part, and it is cached; a run
|
||||||
|
# that takes longer than this has found something pathological and should not
|
||||||
|
# be left running at every login.
|
||||||
|
TimeoutStartSec=180
|
||||||
|
Nice=10
|
||||||
|
IOSchedulingClass=idle
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=default.target
|
||||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
BIN
Binary file not shown.
BIN
Binary file not shown.
BIN
Binary file not shown.
BIN
Binary file not shown.
BIN
Binary file not shown.
BIN
Binary file not shown.
@@ -1,55 +0,0 @@
|
|||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<repomd xmlns="http://linux.duke.edu/metadata/repo" xmlns:rpm="http://linux.duke.edu/metadata/rpm">
|
|
||||||
<revision>1790840268</revision>
|
|
||||||
<data type="primary">
|
|
||||||
<checksum type="sha256">4b563420de21c9a74471f48c37e4902fe0dea9fa3de897fb5239dfb9fa7e597b</checksum>
|
|
||||||
<open-checksum type="sha256">b62388ee596ee8814709637203883274686ae01f265690ac3983b499e0b11139</open-checksum>
|
|
||||||
<location href="repodata/4b563420de21c9a74471f48c37e4902fe0dea9fa3de897fb5239dfb9fa7e597b-primary.xml.gz"/>
|
|
||||||
<timestamp>1790840268</timestamp>
|
|
||||||
<size>2504</size>
|
|
||||||
<open-size>29088</open-size>
|
|
||||||
</data>
|
|
||||||
<data type="filelists">
|
|
||||||
<checksum type="sha256">f6259cf27cddba656fd6e0666db32dcd6a71db222654f7b2bd2281b1dc25c353</checksum>
|
|
||||||
<open-checksum type="sha256">fa7899b8740b988a17d9f72c8ecd0ef193a38405e8071d7b64f65068fd4ff8d1</open-checksum>
|
|
||||||
<location href="repodata/f6259cf27cddba656fd6e0666db32dcd6a71db222654f7b2bd2281b1dc25c353-filelists.xml.gz"/>
|
|
||||||
<timestamp>1790840268</timestamp>
|
|
||||||
<size>1138</size>
|
|
||||||
<open-size>18029</open-size>
|
|
||||||
</data>
|
|
||||||
<data type="other">
|
|
||||||
<checksum type="sha256">1344a28dfc9da86fad8e59a87a6b89e223f621c91bcb44ec45e985f8ba30324b</checksum>
|
|
||||||
<open-checksum type="sha256">b52ce2708e105e7795317490d3ef938dde406f106f8f76712b949655e2db3403</open-checksum>
|
|
||||||
<location href="repodata/1344a28dfc9da86fad8e59a87a6b89e223f621c91bcb44ec45e985f8ba30324b-other.xml.gz"/>
|
|
||||||
<timestamp>1790840268</timestamp>
|
|
||||||
<size>731</size>
|
|
||||||
<open-size>2354</open-size>
|
|
||||||
</data>
|
|
||||||
<data type="primary_db">
|
|
||||||
<checksum type="sha256">89c9eec1c2f214bf8bb46dc9f53bf5645a7b47a156c21e0f4155de3a7797d36a</checksum>
|
|
||||||
<open-checksum type="sha256">57840c8fb2286ddd2642047a3aae97f4c6d37be75daa0a451bd031b291ad2004</open-checksum>
|
|
||||||
<location href="repodata/89c9eec1c2f214bf8bb46dc9f53bf5645a7b47a156c21e0f4155de3a7797d36a-primary.sqlite.bz2"/>
|
|
||||||
<timestamp>1790840268</timestamp>
|
|
||||||
<size>6421</size>
|
|
||||||
<open-size>122880</open-size>
|
|
||||||
<database_version>10</database_version>
|
|
||||||
</data>
|
|
||||||
<data type="filelists_db">
|
|
||||||
<checksum type="sha256">60aa9c1e6a16d73bd88849fca87a5bb98b4a8c6b0b6407d58bf75c0c811306b9</checksum>
|
|
||||||
<open-checksum type="sha256">6d49dea4b82189307007448f86ece1fd4a148fd312fa689705ca1c578f769048</open-checksum>
|
|
||||||
<location href="repodata/60aa9c1e6a16d73bd88849fca87a5bb98b4a8c6b0b6407d58bf75c0c811306b9-filelists.sqlite.bz2"/>
|
|
||||||
<timestamp>1790840268</timestamp>
|
|
||||||
<size>4827</size>
|
|
||||||
<open-size>49152</open-size>
|
|
||||||
<database_version>10</database_version>
|
|
||||||
</data>
|
|
||||||
<data type="other_db">
|
|
||||||
<checksum type="sha256">c78f5fbc5959e285fbbed110f15a760be8fff5d2b0975267880747371e1b3fbf</checksum>
|
|
||||||
<open-checksum type="sha256">f5eed730511defdda7bcb56d23280c80a06513b1a10fcd948af29d28584b36db</open-checksum>
|
|
||||||
<location href="repodata/c78f5fbc5959e285fbbed110f15a760be8fff5d2b0975267880747371e1b3fbf-other.sqlite.bz2"/>
|
|
||||||
<timestamp>1790840268</timestamp>
|
|
||||||
<size>1406</size>
|
|
||||||
<open-size>24576</open-size>
|
|
||||||
<database_version>10</database_version>
|
|
||||||
</data>
|
|
||||||
</repomd>
|
|
||||||
@@ -1,16 +0,0 @@
|
|||||||
-----BEGIN PGP SIGNATURE-----
|
|
||||||
|
|
||||||
iQIzBAABCgAdFiEEY4PI9Dc7LesUkuKsVaPG3ykUTHkFAmq+DcwACgkQVaPG3ykU
|
|
||||||
THn9+A/8DbSMDJvhXoreSx3Qo75rLexIQRogCBepq0PdofvntYEVsr/yIdwun1aj
|
|
||||||
vNjIpIPu/RSn+C3zlIW1WuGBmVx80Tg3FZVWDWftT2SZvaOQD3ab7eNbX7xdCsZJ
|
|
||||||
3ifkYD9hoLNROYqSvxNkkTJ5J+DYF8hdGXcg2AKLGkFcivx+ZYgXX0NfXKBYXzBC
|
|
||||||
pLAi1GFFTsI6hJvbGbPkwMxZu9nB8ptLH8Lfk7tsYWnRFN6uM+nmRAVue2SGv+ib
|
|
||||||
VgWgD8ZYCWaTP4T/fpMkqVwyJzRpLACqMBJov4WF3KWk9bJn/H8/VPnPQ3+uix6X
|
|
||||||
/fUNPvYpx1QgSNPbPBfLx0hkMp6n1Z3LvnaeACcx4KqusD0SByhWspdAzxIQdUZ3
|
|
||||||
/Ai/F0MMYNaEg8jD4qwDZMWMZHl21Sa9afCa2xv4e/xvytdoCaSJ4x6YiMLgrcp5
|
|
||||||
qohbP38aYNiCgL7inDkRlOLU+pZTsLVfvZkhnjT4NZkCdQQpk2nspaLIEj639b23
|
|
||||||
b/Ru6d+8U9riH9yBcIGQj25phOEbWosZpsd6uN/RRd3M05dtDlFrGZP5gvkbY4Ui
|
|
||||||
Cq6XzVRYbFnHZLvcnDLNcGz4o0ilIpqqbH6ytpL8DyKK4oW3jlyc61OJElnrObgU
|
|
||||||
SYYV76sCoDjCwhFeRFVX/5G9av0WFfHCVIfB8vzLlKVuRQKc00g=
|
|
||||||
=xMAp
|
|
||||||
-----END PGP SIGNATURE-----
|
|
||||||
@@ -0,0 +1,292 @@
|
|||||||
|
# shellcheck shell=bash
|
||||||
|
#
|
||||||
|
# Deciding what happens to each application, and doing it.
|
||||||
|
#
|
||||||
|
# The routing lives in mca_route and is used twice: once by mca_apply to patch
|
||||||
|
# and once by the applications screen to show what would happen. Keeping it in
|
||||||
|
# one function is what makes that screen trustworthy - it is not a description
|
||||||
|
# of the behaviour, it is the behaviour.
|
||||||
|
|
||||||
|
MCA_CHANGES=0
|
||||||
|
MCA_ROUTES=()
|
||||||
|
|
||||||
|
# mca_route <kind> <id> <program> [packaging]
|
||||||
|
# What happens to one application, left in MCA_ROUTE:
|
||||||
|
# flags - the launcher reads a flag file; write it there
|
||||||
|
# desktop - no flag file; shadow or edit the desktop entry
|
||||||
|
# steam - Steam's own two-part treatment
|
||||||
|
# unknown - cannot tell what engine this is (an AppImage), so nothing is done
|
||||||
|
# off - detected, but switched off
|
||||||
|
#
|
||||||
|
# Assigns rather than prints so the memo inside mca_has_flags_file survives:
|
||||||
|
# from inside a command substitution it would be filled in a subshell and
|
||||||
|
# thrown away, which is the whole point of having it.
|
||||||
|
MCA_ROUTE=''
|
||||||
|
|
||||||
|
mca_route() {
|
||||||
|
local kind="$1" id="$2" prog="$3" packaging="${4:-native}"
|
||||||
|
|
||||||
|
if [[ $kind == steam ]]; then
|
||||||
|
if mca_config_list_has Skip "$id" || [[ $CFG_STEAM != yes ]]; then
|
||||||
|
MCA_ROUTE=off
|
||||||
|
else
|
||||||
|
MCA_ROUTE=steam
|
||||||
|
fi
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
|
||||||
|
if ! mca_kind_wanted "$kind" "$id" "$packaging"; then
|
||||||
|
[[ $kind == unknown ]] && MCA_ROUTE=unknown || MCA_ROUTE=off
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
|
||||||
|
# A Flatpak or a snap carries its own copy of everything and sees none of
|
||||||
|
# the host's wrappers, so the desktop entry is the only way in.
|
||||||
|
if [[ $packaging != native ]]; then
|
||||||
|
MCA_ROUTE=desktop
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
|
||||||
|
if mca_has_flags_file "$prog"; then
|
||||||
|
MCA_ROUTE=flags
|
||||||
|
else
|
||||||
|
MCA_ROUTE=desktop
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_apply
|
||||||
|
# Brings everything into line with the current settings. Safe to run as often
|
||||||
|
# as it likes to be - it writes only what differs, which is what keeps the
|
||||||
|
# watcher from chasing its own changes.
|
||||||
|
mca_apply() {
|
||||||
|
local i id file prog kind packaging route steam_done=0
|
||||||
|
|
||||||
|
MCA_CHANGES=0
|
||||||
|
MCA_ROUTES=()
|
||||||
|
MCA_N_ON=0; MCA_N_OFF=0; MCA_N_UNKNOWN=0
|
||||||
|
|
||||||
|
mca_config_load
|
||||||
|
|
||||||
|
# An installation that was set up by a version whose answer was a different
|
||||||
|
# flag still has that flag where it put it, and nothing below would touch it
|
||||||
|
# again: a file that is already marked as patched is left alone. Taking
|
||||||
|
# everything back once, here, is what carries such an installation over.
|
||||||
|
if [[ "$(mca_state_read flag_scheme 1)" != "$MCA_FLAG_SCHEME" ]]; then
|
||||||
|
mca_revert_all
|
||||||
|
fi
|
||||||
|
|
||||||
|
mca_scan
|
||||||
|
|
||||||
|
for i in "${!MCA_IDS[@]}"; do
|
||||||
|
id="${MCA_IDS[i]}"
|
||||||
|
file="${MCA_FILES[i]}"
|
||||||
|
prog="${MCA_PROGS[i]}"
|
||||||
|
kind="${MCA_KINDS[i]}"
|
||||||
|
packaging="${MCA_PACKAGING[i]}"
|
||||||
|
|
||||||
|
mca_route "$kind" "$id" "$prog" "$packaging"
|
||||||
|
route="$MCA_ROUTE"
|
||||||
|
MCA_ROUTES[i]="$route"
|
||||||
|
|
||||||
|
case "$route" in
|
||||||
|
unknown) MCA_N_UNKNOWN=$(( MCA_N_UNKNOWN + 1 )) ;;
|
||||||
|
off) MCA_N_OFF=$(( MCA_N_OFF + 1 )) ;;
|
||||||
|
*) MCA_N_ON=$(( MCA_N_ON + 1 )) ;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
case "$route" in
|
||||||
|
flags)
|
||||||
|
mca_flags_apply "$prog" "$kind" \
|
||||||
|
|| mca_desktop_apply "$id" "$file" "$(mca_flags "$kind")"
|
||||||
|
;;
|
||||||
|
desktop)
|
||||||
|
mca_desktop_apply "$id" "$file" "$(mca_flags "$kind")"
|
||||||
|
;;
|
||||||
|
steam)
|
||||||
|
mca_steam_desktop_apply "$id" "$file" "$packaging"
|
||||||
|
if (( ! steam_done )); then
|
||||||
|
mca_steam_apply
|
||||||
|
steam_done=1
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
|
||||||
|
# Steam is worth patching even when its desktop entry is missing - a user
|
||||||
|
# who starts it from a script or a game launcher still gets the interface.
|
||||||
|
if [[ $CFG_STEAM == yes ]] && (( ! steam_done )) && mca_steam_installed; then
|
||||||
|
mca_steam_apply
|
||||||
|
fi
|
||||||
|
|
||||||
|
# The shortcuts Steam writes for single games. They are not applications
|
||||||
|
# and are not offered as ones, but starting a game with Steam closed is a
|
||||||
|
# Steam start like any other: without the switch the client finds the
|
||||||
|
# patched helper script, puts its own back, and the interface loses
|
||||||
|
# autoscroll for the rest of the session.
|
||||||
|
if [[ $CFG_STEAM == yes ]]; then
|
||||||
|
for i in "${!MCA_STEAM_LINKS[@]}"; do
|
||||||
|
mca_steam_desktop_apply "${MCA_STEAM_LINKS[i]}" \
|
||||||
|
"${MCA_STEAM_LINK_FILES[i]}" "${MCA_STEAM_LINK_PACK[i]}"
|
||||||
|
done
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Steam's autostart entry carries Steam's own switch and follows the Steam
|
||||||
|
# setting, not this one - leaving it out while Steam is patched is what puts
|
||||||
|
# the client in an update loop - so both are checked inside.
|
||||||
|
if [[ $CFG_AUTOSTART == yes || $CFG_STEAM == yes ]]; then
|
||||||
|
mca_autostart_apply
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Shortcuts on the desktop itself. Nothing above has seen them - the XDG
|
||||||
|
# search path does not go there - and a game started from one starts Steam
|
||||||
|
# without its switch, which is the difference between autoscroll working
|
||||||
|
# and autoscroll working most of the time. Each entry is gated on its own,
|
||||||
|
# so there is nothing to check out here.
|
||||||
|
mca_shortcuts_apply
|
||||||
|
|
||||||
|
[[ $CFG_SPOTIFY == yes ]] && mca_spotify_apply
|
||||||
|
|
||||||
|
mca_prune_orphans
|
||||||
|
|
||||||
|
if (( MCA_CHANGES )) && mca_have update-desktop-database; then
|
||||||
|
update-desktop-database "$MCA_APPDIR" 2>/dev/null || true
|
||||||
|
fi
|
||||||
|
|
||||||
|
mca_state_write last_apply "$(date +%s)"
|
||||||
|
mca_state_write flag_scheme "$MCA_FLAG_SCHEME"
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_revert
|
||||||
|
# Undoes every recorded change and forgets them.
|
||||||
|
mca_revert() {
|
||||||
|
MCA_CHANGES=0
|
||||||
|
mca_revert_all
|
||||||
|
|
||||||
|
if (( MCA_CHANGES )) && mca_have update-desktop-database; then
|
||||||
|
update-desktop-database "$MCA_APPDIR" 2>/dev/null || true
|
||||||
|
fi
|
||||||
|
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# The watcher
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# A systemd user path unit watching every directory a desktop entry can appear
|
||||||
|
# in. That covers a package from whatever the distribution's package manager
|
||||||
|
# is, a Flatpak, a snap, an AppImage registered by hand and a Steam client
|
||||||
|
# update, without a hook per package manager.
|
||||||
|
|
||||||
|
MCA_UNIT_PATH="middleclick-autoscroll.path"
|
||||||
|
MCA_UNIT_SERVICE="middleclick-autoscroll.service"
|
||||||
|
|
||||||
|
# The desktop folder is watched like every other directory an entry can turn up
|
||||||
|
# in, but its name is translated and the unit that ships with the package
|
||||||
|
# cannot know it. So that one path is written here, into a drop-in, from the
|
||||||
|
# name this system actually uses.
|
||||||
|
MCA_UNIT_DROPIN="${MCA_XDG_CONFIG}/systemd/user/${MCA_UNIT_PATH}.d"
|
||||||
|
|
||||||
|
mca_watch_available() {
|
||||||
|
mca_have systemctl && [[ -n ${XDG_RUNTIME_DIR:-} || -S "/run/user/$(id -u)/bus" ]]
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_watch_enabled() {
|
||||||
|
mca_watch_available || return 1
|
||||||
|
systemctl --user is-enabled --quiet "$MCA_UNIT_PATH" 2>/dev/null
|
||||||
|
}
|
||||||
|
|
||||||
|
# _mca_watch_dropin_write
|
||||||
|
# Returns 0 when the drop-in changed and systemd has to be told, 1 when it was
|
||||||
|
# already right - the same contract as mca_write_if_changed, and for the same
|
||||||
|
# reason: the watcher runs after every desktop entry that appears anywhere on
|
||||||
|
# the system, and a daemon-reload each time would be absurd.
|
||||||
|
_mca_watch_dropin_write() {
|
||||||
|
local dir file="$MCA_UNIT_DROPIN/desktop.conf" content
|
||||||
|
|
||||||
|
dir="$(mca_desktop_folder)"
|
||||||
|
[[ -d $dir ]] || { _mca_watch_dropin_remove; return $?; }
|
||||||
|
|
||||||
|
# A per cent sign starts a specifier in a unit file and has to be doubled
|
||||||
|
# to mean itself. Rare in a folder name, fatal when it happens.
|
||||||
|
content="[Path]"$'\n'"PathModified=${dir//%/%%}"$'\n'
|
||||||
|
|
||||||
|
mca_write_if_changed "$file" "$content"
|
||||||
|
}
|
||||||
|
|
||||||
|
_mca_watch_dropin_remove() {
|
||||||
|
[[ -e "$MCA_UNIT_DROPIN/desktop.conf" ]] || return 1
|
||||||
|
rm -f -- "$MCA_UNIT_DROPIN/desktop.conf"
|
||||||
|
rmdir "$MCA_UNIT_DROPIN" 2>/dev/null || true
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_watch_enable() {
|
||||||
|
mca_watch_available || return 1
|
||||||
|
_mca_watch_dropin_write
|
||||||
|
systemctl --user daemon-reload > /dev/null 2>&1 || true
|
||||||
|
systemctl --user enable --now "$MCA_UNIT_PATH" > /dev/null 2>&1 || return 1
|
||||||
|
systemctl --user enable "$MCA_UNIT_SERVICE" > /dev/null 2>&1 || true
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_watch_refresh
|
||||||
|
# Keeps a running watcher in step with a desktop folder that has been renamed,
|
||||||
|
# which is what a change of session language does to it.
|
||||||
|
mca_watch_refresh() {
|
||||||
|
mca_watch_available || return 0
|
||||||
|
_mca_watch_dropin_write || return 0
|
||||||
|
systemctl --user daemon-reload > /dev/null 2>&1 || true
|
||||||
|
systemctl --user restart "$MCA_UNIT_PATH" > /dev/null 2>&1 || true
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_watch_disable() {
|
||||||
|
mca_watch_available || return 0
|
||||||
|
systemctl --user disable --now "$MCA_UNIT_PATH" > /dev/null 2>&1 || true
|
||||||
|
systemctl --user disable "$MCA_UNIT_SERVICE" > /dev/null 2>&1 || true
|
||||||
|
_mca_watch_dropin_remove && systemctl --user daemon-reload > /dev/null 2>&1
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Reporting
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# mca_count_routes
|
||||||
|
# Fills MCA_N_ON / MCA_N_OFF / MCA_N_UNKNOWN from a scan, without writing
|
||||||
|
# anything. Used by the status block and the menu header.
|
||||||
|
MCA_N_ON=0
|
||||||
|
MCA_N_OFF=0
|
||||||
|
MCA_N_UNKNOWN=0
|
||||||
|
|
||||||
|
mca_count_routes() {
|
||||||
|
local i route
|
||||||
|
|
||||||
|
MCA_N_ON=0; MCA_N_OFF=0; MCA_N_UNKNOWN=0
|
||||||
|
MCA_ROUTES=()
|
||||||
|
|
||||||
|
for i in "${!MCA_IDS[@]}"; do
|
||||||
|
mca_route "${MCA_KINDS[i]}" "${MCA_IDS[i]}" "${MCA_PROGS[i]}" \
|
||||||
|
"${MCA_PACKAGING[i]}"
|
||||||
|
route="$MCA_ROUTE"
|
||||||
|
MCA_ROUTES[i]="$route"
|
||||||
|
case "$route" in
|
||||||
|
unknown) MCA_N_UNKNOWN=$(( MCA_N_UNKNOWN + 1 )) ;;
|
||||||
|
off) MCA_N_OFF=$(( MCA_N_OFF + 1 )) ;;
|
||||||
|
*) MCA_N_ON=$(( MCA_N_ON + 1 )) ;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_route_label <route>
|
||||||
|
mca_route_label() {
|
||||||
|
case "$1" in
|
||||||
|
flags) mca_msg "flag file" ;;
|
||||||
|
desktop) mca_msg "launcher" ;;
|
||||||
|
steam) mca_msg "Steam" ;;
|
||||||
|
unknown) mca_msg "cannot tell" ;;
|
||||||
|
*) mca_msg "off" ;;
|
||||||
|
esac
|
||||||
|
printf '\n'
|
||||||
|
}
|
||||||
@@ -0,0 +1,345 @@
|
|||||||
|
# shellcheck shell=bash
|
||||||
|
#
|
||||||
|
# Paths, translations, output helpers and the change ledger.
|
||||||
|
#
|
||||||
|
# Everything here runs unprivileged. This tool only ever writes inside the
|
||||||
|
# user's own home - flag files, desktop entries, Steam's own scripts - so there
|
||||||
|
# is no system state to guard and nothing that needs root.
|
||||||
|
|
||||||
|
MCA_VERSION="@VERSION@"
|
||||||
|
MCA_NAME="middleclick-autoscroll"
|
||||||
|
MCA_PRETTY="Middle-Click Autoscroll"
|
||||||
|
|
||||||
|
# The whole point of the package. Blink implements Windows-style autoscroll
|
||||||
|
# behind a runtime flag that Chromium does not turn on for Linux, because
|
||||||
|
# middle click is taken by primary-selection paste there.
|
||||||
|
#
|
||||||
|
# There are two ways to ask for that flag, and which one is right depends on
|
||||||
|
# what is being started:
|
||||||
|
#
|
||||||
|
# --enable-blink-features=MiddleClickAutoscroll is the one that works
|
||||||
|
# everywhere, and the only one that works in the Chromium versions embedded
|
||||||
|
# applications ship - Steam's CEF, an Electron a few years old, anything
|
||||||
|
# before Chromium 124. A browser started with it puts a yellow bar above the
|
||||||
|
# page saying an unsupported command line flag is in use, because Chromium
|
||||||
|
# keeps a list of flags worth warning about and this is on it.
|
||||||
|
#
|
||||||
|
# --enable-features=MiddleClickAutoscroll is not on that list, so a browser
|
||||||
|
# started with it says nothing. Blink generates a feature of the same name
|
||||||
|
# for every one of its runtime flags, which is what makes the two the same
|
||||||
|
# request - but only since Chromium 124. Before that the name means nothing
|
||||||
|
# and is ignored without a word.
|
||||||
|
#
|
||||||
|
# So a browser, which is the only thing that shows the bar and the one thing
|
||||||
|
# that keeps itself up to date, is given the quiet one; everything else keeps
|
||||||
|
# the one that always works.
|
||||||
|
MCA_FLAG="--enable-blink-features=MiddleClickAutoscroll"
|
||||||
|
|
||||||
|
# Helium ships the feature under its own name and does not answer to the
|
||||||
|
# Chromium one, so browsers are asked for both. A name a browser does not know
|
||||||
|
# is ignored, which is what makes one list safe to hand to all of them.
|
||||||
|
MCA_BROWSER_FLAG="--enable-features=MiddleClickAutoscroll,HeliumMiddleClickAutoscroll"
|
||||||
|
|
||||||
|
# The feature names on their own, for merging into a list that an application
|
||||||
|
# (or the user) already carries, and for taking them back out again.
|
||||||
|
MCA_FEATURE="MiddleClickAutoscroll"
|
||||||
|
MCA_BROWSER_FEATURES="MiddleClickAutoscroll,HeliumMiddleClickAutoscroll"
|
||||||
|
|
||||||
|
# Bumped when the flags above change. An installation that was set up by a
|
||||||
|
# version with a different answer is taken back and done again once, because a
|
||||||
|
# file that is already patched is otherwise left alone. See mca_apply.
|
||||||
|
MCA_FLAG_SCHEME=2
|
||||||
|
|
||||||
|
MCA_LIBDIR="${MCA_LIBDIR:-@LIBDIR@}"
|
||||||
|
MCA_LOCALEDIR="${MCA_LOCALEDIR:-@LOCALEDIR@}"
|
||||||
|
|
||||||
|
MCA_XDG_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}"
|
||||||
|
MCA_XDG_DATA="${XDG_DATA_HOME:-$HOME/.local/share}"
|
||||||
|
MCA_XDG_STATE="${XDG_STATE_HOME:-$HOME/.local/state}"
|
||||||
|
MCA_XDG_CACHE="${XDG_CACHE_HOME:-$HOME/.cache}"
|
||||||
|
|
||||||
|
MCA_CONFDIR="${MCA_CONFDIR:-${MCA_XDG_CONFIG}/${MCA_NAME}}"
|
||||||
|
MCA_CONFIG="${MCA_CONFIG:-${MCA_CONFDIR}/config}"
|
||||||
|
MCA_STATEDIR="${MCA_STATEDIR:-${MCA_XDG_STATE}/${MCA_NAME}}"
|
||||||
|
MCA_CACHEDIR="${MCA_CACHEDIR:-${MCA_XDG_CACHE}/${MCA_NAME}}"
|
||||||
|
|
||||||
|
# Where generated desktop entries go. A file here shadows the one with the same
|
||||||
|
# name in /usr/share/applications, which is how an application gets extra
|
||||||
|
# command line arguments without touching a file the package manager owns.
|
||||||
|
MCA_APPDIR="${MCA_XDG_DATA}/applications"
|
||||||
|
|
||||||
|
# Copies of every file that is edited in place rather than shadowed.
|
||||||
|
MCA_BACKUPDIR="${MCA_STATEDIR}/backup"
|
||||||
|
|
||||||
|
# One line per change, so `revert` can undo exactly what was done and nothing
|
||||||
|
# else. See mca_ledger_add.
|
||||||
|
MCA_LEDGER="${MCA_STATEDIR}/ledger"
|
||||||
|
|
||||||
|
# The folder the desktop itself shows. Nothing in the XDG search path looks at
|
||||||
|
# it, so an entry that lives only there is invisible to a scan - and a game
|
||||||
|
# shortcut dragged onto the desktop is exactly that.
|
||||||
|
#
|
||||||
|
# Its name is translated: Schreibtisch, Bureau, Escritorio. The name in use is
|
||||||
|
# in the file xdg-user-dirs writes, so it is read rather than guessed, and
|
||||||
|
# ~/Desktop is only the fallback for a system that has no such file.
|
||||||
|
mca_desktop_folder() {
|
||||||
|
local file="$MCA_XDG_CONFIG/user-dirs.dirs" line dir=''
|
||||||
|
|
||||||
|
if [[ -r $file ]]; then
|
||||||
|
while IFS= read -r line; do
|
||||||
|
[[ $line == XDG_DESKTOP_DIR=* ]] || continue
|
||||||
|
dir="${line#XDG_DESKTOP_DIR=}"
|
||||||
|
dir="${dir%\"}"; dir="${dir#\"}"
|
||||||
|
done < "$file"
|
||||||
|
dir="${dir/#\$HOME/$HOME}"
|
||||||
|
fi
|
||||||
|
|
||||||
|
[[ $dir == /* ]] || dir="$HOME/Desktop"
|
||||||
|
printf '%s\n' "${dir%/}"
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Translations
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export TEXTDOMAIN="middleclick-autoscroll"
|
||||||
|
export TEXTDOMAINDIR="${MCA_LOCALEDIR}"
|
||||||
|
|
||||||
|
mca_ui_locale() {
|
||||||
|
local l="${MCA_UI_LOCALE:-}"
|
||||||
|
|
||||||
|
if [[ -z $l ]]; then
|
||||||
|
l="${LC_ALL:-}"
|
||||||
|
[[ -z $l ]] && l="${LC_MESSAGES:-}"
|
||||||
|
[[ -z $l ]] && l="${LANG:-}"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# systemd writes /etc/locale.conf and most distributions use it; Debian and
|
||||||
|
# Ubuntu keep the same LANG= line in /etc/default/locale instead.
|
||||||
|
if [[ -z $l ]]; then
|
||||||
|
local f
|
||||||
|
for f in /etc/locale.conf /etc/default/locale; do
|
||||||
|
[[ -r $f ]] || continue
|
||||||
|
l="$(sed -n 's/^LANG=//p' "$f" | tr -d '"' | head -n1)"
|
||||||
|
[[ -n $l ]] && break
|
||||||
|
done
|
||||||
|
fi
|
||||||
|
|
||||||
|
printf '%s\n' "${l:-C}"
|
||||||
|
}
|
||||||
|
|
||||||
|
# Every gettext lookup is a fork and the settings screen redraws a screenful of
|
||||||
|
# labels per keypress, so results are memoized.
|
||||||
|
declare -A MCA_MSG_CACHE=()
|
||||||
|
|
||||||
|
MCA_MSG_RESULT=''
|
||||||
|
|
||||||
|
# mca_msg_into <locale> <msgid>
|
||||||
|
# Plain lookup with the result in MCA_MSG_RESULT and no printf formatting, for
|
||||||
|
# callers that would otherwise pay a fork per label per frame.
|
||||||
|
mca_msg_into() {
|
||||||
|
local locale="$1" msgid="$2" cachekey
|
||||||
|
cachekey="${locale}"$'\x1f'"${msgid}"
|
||||||
|
|
||||||
|
if [[ -n ${MCA_MSG_CACHE[$cachekey]+set} ]]; then
|
||||||
|
MCA_MSG_RESULT="${MCA_MSG_CACHE[$cachekey]}"
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
MCA_MSG_RESULT="$(LC_ALL="$locale" LANGUAGE="${locale%%.*}" gettext -- "$msgid" 2>/dev/null)"
|
||||||
|
[[ -n $MCA_MSG_RESULT ]] || MCA_MSG_RESULT="$msgid"
|
||||||
|
MCA_MSG_CACHE[$cachekey]="$MCA_MSG_RESULT"
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_msg_in <locale> <msgid> [printf args...]
|
||||||
|
mca_msg_in() {
|
||||||
|
local locale="$1" msgid="$2" translated cachekey
|
||||||
|
shift 2
|
||||||
|
|
||||||
|
cachekey="${locale}"$'\x1f'"${msgid}"
|
||||||
|
if [[ -n ${MCA_MSG_CACHE[$cachekey]+set} ]]; then
|
||||||
|
translated="${MCA_MSG_CACHE[$cachekey]}"
|
||||||
|
else
|
||||||
|
translated="$(LC_ALL="$locale" LANGUAGE="${locale%%.*}" gettext -- "$msgid" 2>/dev/null)"
|
||||||
|
[[ -n $translated ]] || translated="$msgid"
|
||||||
|
MCA_MSG_CACHE[$cachekey]="$translated"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# With no arguments the message is plain text, not a format string. Feeding
|
||||||
|
# it to printf anyway would turn a literal percent sign in a translation
|
||||||
|
# into an invalid conversion.
|
||||||
|
if (( $# == 0 )); then
|
||||||
|
printf '%s' "$translated"
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
|
||||||
|
# shellcheck disable=SC2059 # the format string is the translated message
|
||||||
|
printf -- "$translated" "$@"
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_msg <msgid> [printf args...]
|
||||||
|
mca_msg() { mca_msg_in "$(mca_ui_locale)" "$@"; }
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Output
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# Decided once, while stdout is still whatever the process was started with:
|
||||||
|
# testing -t 1 at the point of use is wrong for anything called through $(...),
|
||||||
|
# which sees a pipe and would conclude nobody is watching.
|
||||||
|
MCA_INTERACTIVE=''
|
||||||
|
[[ -t 1 ]] && MCA_INTERACTIVE=1
|
||||||
|
|
||||||
|
if [[ -n $MCA_INTERACTIVE && -z ${NO_COLOR:-} ]]; then
|
||||||
|
MCA_C_RESET=$'\033[0m'
|
||||||
|
MCA_C_BOLD=$'\033[1m'
|
||||||
|
MCA_C_DIM=$'\033[2m'
|
||||||
|
MCA_C_BLUE=$'\033[38;2;23;147;209m'
|
||||||
|
MCA_C_GREEN=$'\033[32m'
|
||||||
|
MCA_C_YELLOW=$'\033[33m'
|
||||||
|
MCA_C_RED=$'\033[31m'
|
||||||
|
else
|
||||||
|
MCA_C_RESET='' MCA_C_BOLD='' MCA_C_DIM='' MCA_C_BLUE=''
|
||||||
|
MCA_C_GREEN='' MCA_C_YELLOW='' MCA_C_RED=''
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Set by mca_bad and mca_note. The menu redraws straight after an action, which
|
||||||
|
# would wipe the screen; this marks that something was printed the user still
|
||||||
|
# has to read. A plain success needs no acknowledgement - the status block at
|
||||||
|
# the top of the menu already shows the new state.
|
||||||
|
MCA_UI_NEEDS_ACK=''
|
||||||
|
|
||||||
|
# --quiet silences progress chatter; errors still go to stderr. Used by the
|
||||||
|
# systemd unit, which has no terminal and logs to the journal anyway.
|
||||||
|
MCA_QUIET=''
|
||||||
|
|
||||||
|
mca_say() { [[ -n $MCA_QUIET ]] || printf '%s\n' "$*"; }
|
||||||
|
mca_head() { printf '\n%s%s%s\n\n' "$MCA_C_BOLD$MCA_C_BLUE" "$*" "$MCA_C_RESET"; }
|
||||||
|
mca_ok() { [[ -n $MCA_QUIET ]] || printf '%s✔%s %s\n' "$MCA_C_GREEN" "$MCA_C_RESET" "$*"; }
|
||||||
|
mca_bad() { MCA_UI_NEEDS_ACK=1; printf '%s✘%s %s\n' "$MCA_C_RED" "$MCA_C_RESET" "$*" >&2; }
|
||||||
|
mca_note() { MCA_UI_NEEDS_ACK=1; [[ -n $MCA_QUIET ]] || printf '%s•%s %s\n' "$MCA_C_DIM" "$MCA_C_RESET" "$*"; }
|
||||||
|
|
||||||
|
mca_have() { command -v "$1" > /dev/null 2>&1; }
|
||||||
|
|
||||||
|
# Human-readable "x minutes ago" for a unix timestamp. Empty input yields the
|
||||||
|
# translated "never".
|
||||||
|
mca_time_ago() {
|
||||||
|
local ts="$1" now delta
|
||||||
|
|
||||||
|
[[ $ts =~ ^[0-9]+$ ]] || { mca_msg "never"; printf '\n'; return; }
|
||||||
|
|
||||||
|
now="$(date +%s)"
|
||||||
|
delta=$(( now - ts ))
|
||||||
|
(( delta < 0 )) && delta=0
|
||||||
|
|
||||||
|
if (( delta < 60 )); then mca_msg "just now"
|
||||||
|
elif (( delta < 3600 )); then mca_msg "%d minutes ago" "$(( delta / 60 ))"
|
||||||
|
elif (( delta < 86400 )); then mca_msg "%d hours ago" "$(( delta / 3600 ))"
|
||||||
|
else mca_msg "%d days ago" "$(( delta / 86400 ))"
|
||||||
|
fi
|
||||||
|
printf '\n'
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# State
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
mca_state_read() {
|
||||||
|
local key="$1" default="${2:-}"
|
||||||
|
if [[ -r "$MCA_STATEDIR/$key" ]]; then
|
||||||
|
cat "$MCA_STATEDIR/$key"
|
||||||
|
else
|
||||||
|
printf '%s\n' "$default"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_state_write() {
|
||||||
|
local key="$1"
|
||||||
|
shift
|
||||||
|
mkdir -p "$MCA_STATEDIR" 2>/dev/null || return 1
|
||||||
|
printf '%s\n' "$*" > "$MCA_STATEDIR/$key"
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# The change ledger
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Reverting by pattern - "delete every desktop entry that mentions the flag" -
|
||||||
|
# would also delete entries the user wrote by hand. So every change is recorded
|
||||||
|
# instead, and `revert` replays the ledger backwards.
|
||||||
|
#
|
||||||
|
# Format, tab separated:
|
||||||
|
# <kind> <path> <detail>
|
||||||
|
#
|
||||||
|
# shadow <generated desktop entry> <source entry it was generated from>
|
||||||
|
# inplace <edited file> <basename of its backup copy>
|
||||||
|
# flags <flag file> created | appended | merged
|
||||||
|
#
|
||||||
|
# `inplace` and `flags` differ in how they are undone: a backup is restored
|
||||||
|
# wholesale, a flag file only loses the one line that was added to it.
|
||||||
|
|
||||||
|
mca_ledger_add() {
|
||||||
|
local kind="$1" path="$2" detail="${3:-}"
|
||||||
|
mkdir -p "$MCA_STATEDIR" 2>/dev/null || return 1
|
||||||
|
|
||||||
|
# Never record the same path twice: applying repeatedly is normal (the path
|
||||||
|
# unit fires on every desktop file that appears) and the ledger has to stay
|
||||||
|
# a set, not a log.
|
||||||
|
mca_ledger_forget "$path"
|
||||||
|
printf '%s\t%s\t%s\n' "$kind" "$path" "$detail" >> "$MCA_LEDGER"
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_ledger_forget() {
|
||||||
|
local path="$1" tmp
|
||||||
|
[[ -f $MCA_LEDGER ]] || return 0
|
||||||
|
|
||||||
|
tmp="$(mktemp "${MCA_LEDGER}.XXXXXX")" || return 1
|
||||||
|
awk -F'\t' -v p="$path" '$2 != p' "$MCA_LEDGER" > "$tmp" 2>/dev/null \
|
||||||
|
&& mv -f "$tmp" "$MCA_LEDGER" || rm -f "$tmp"
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
# mca_backup_name <file>
|
||||||
|
# The name a backup copy of that file is stored under. Derived from the path
|
||||||
|
# rather than remembered, so a caller can ask whether a file has been backed up
|
||||||
|
# before without reading the ledger.
|
||||||
|
mca_backup_name() {
|
||||||
|
printf '%s' "$1" | sed 's|/|%|g'
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_backup <file>
|
||||||
|
# Copies a file aside before it is edited in place, and prints the name the
|
||||||
|
# copy was stored under. Existing backups are never overwritten: the first copy
|
||||||
|
# is the pristine one, and a second apply must not replace it with an already
|
||||||
|
# patched version.
|
||||||
|
mca_backup() {
|
||||||
|
local file="$1" name
|
||||||
|
name="$(mca_backup_name "$file")"
|
||||||
|
|
||||||
|
mkdir -p "$MCA_BACKUPDIR" 2>/dev/null || return 1
|
||||||
|
if [[ ! -e "$MCA_BACKUPDIR/$name" ]]; then
|
||||||
|
cp -p -- "$file" "$MCA_BACKUPDIR/$name" 2>/dev/null || return 1
|
||||||
|
fi
|
||||||
|
printf '%s\n' "$name"
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_write_if_changed <path> <content>
|
||||||
|
# Writing a file that is already correct would touch its mtime, and the systemd
|
||||||
|
# path unit watches these directories: an unconditional write would retrigger
|
||||||
|
# the service, which would write again, forever.
|
||||||
|
mca_write_if_changed() {
|
||||||
|
local path="$1" content="$2" current=''
|
||||||
|
|
||||||
|
[[ -r $path ]] && current="$(< "$path")"
|
||||||
|
|
||||||
|
# $(< file) drops trailing newlines and callers pass content that ends in
|
||||||
|
# one, so both sides are trimmed before comparing. Getting this wrong makes
|
||||||
|
# every file look changed on every run, which is exactly the feedback loop
|
||||||
|
# this function exists to prevent.
|
||||||
|
[[ "${current%"${current##*[!$'\n']}"}" == "${content%"${content##*[!$'\n']}"}" ]] && return 1
|
||||||
|
|
||||||
|
mkdir -p "$(dirname "$path")" 2>/dev/null || return 2
|
||||||
|
printf '%s' "$content" > "$path" || return 2
|
||||||
|
return 0
|
||||||
|
}
|
||||||
@@ -0,0 +1,171 @@
|
|||||||
|
# shellcheck shell=bash
|
||||||
|
#
|
||||||
|
# Reading and writing ~/.config/middleclick-autoscroll/config.
|
||||||
|
#
|
||||||
|
# The file exists so the tool has somewhere to remember what it was told; it is
|
||||||
|
# not meant to be edited. Every option it holds is reachable from the interface,
|
||||||
|
# which is why there is no commented template shipped anywhere and no reference
|
||||||
|
# to the path in the interface itself.
|
||||||
|
#
|
||||||
|
# It is parsed rather than sourced. One "Key=Value" per line, '#' comments.
|
||||||
|
|
||||||
|
MCA_CONFIG_CACHE=''
|
||||||
|
MCA_CONFIG_CACHED=0
|
||||||
|
|
||||||
|
_mca_config_slurp() {
|
||||||
|
(( MCA_CONFIG_CACHED )) && return 0
|
||||||
|
MCA_CONFIG_CACHE=''
|
||||||
|
[[ -r $MCA_CONFIG ]] && MCA_CONFIG_CACHE="$(< "$MCA_CONFIG")"
|
||||||
|
MCA_CONFIG_CACHED=1
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# _mca_config_lookup <Key> [default]
|
||||||
|
# Result in MCA_CONFIG_VALUE. Assigning rather than printing matters on the
|
||||||
|
# settings screen, which reads every key on every frame: a command substitution
|
||||||
|
# there is a fork, and forks are the whole cost of a redraw.
|
||||||
|
MCA_CONFIG_VALUE=''
|
||||||
|
|
||||||
|
_mca_config_lookup() {
|
||||||
|
local key="$1" default="${2:-}" val='' line
|
||||||
|
|
||||||
|
MCA_CONFIG_VALUE="$default"
|
||||||
|
[[ -r $MCA_CONFIG ]] || return 0
|
||||||
|
_mca_config_slurp
|
||||||
|
|
||||||
|
while IFS= read -r line; do
|
||||||
|
[[ $line == *"$key"* ]] || continue
|
||||||
|
[[ $line =~ ^[[:space:]]*"$key"[[:space:]]*=(.*)$ ]] || continue
|
||||||
|
val="${BASH_REMATCH[1]}"
|
||||||
|
done <<< "$MCA_CONFIG_CACHE"
|
||||||
|
|
||||||
|
val="${val%%#*}"
|
||||||
|
val="${val#"${val%%[![:space:]]*}"}"
|
||||||
|
val="${val%"${val##*[![:space:]]}"}"
|
||||||
|
val="${val%\"}"
|
||||||
|
val="${val#\"}"
|
||||||
|
|
||||||
|
[[ -n $val ]] && MCA_CONFIG_VALUE="$val"
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_config_get <Key> [default]
|
||||||
|
mca_config_get() {
|
||||||
|
_mca_config_lookup "$@"
|
||||||
|
printf '%s\n' "$MCA_CONFIG_VALUE"
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_config_bool <Key> <default: yes|no>
|
||||||
|
mca_config_bool() {
|
||||||
|
local val
|
||||||
|
val="$(mca_config_get "$1" "$2")"
|
||||||
|
case "${val,,}" in
|
||||||
|
yes|y|true|1|on|enabled) return 0 ;;
|
||||||
|
*) return 1 ;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_config_set <Key> <Value>
|
||||||
|
mca_config_set() {
|
||||||
|
local key="$1" value="$2" tmp
|
||||||
|
|
||||||
|
if [[ ! -e $MCA_CONFIG ]]; then
|
||||||
|
mkdir -p "$(dirname "$MCA_CONFIG")" || return 1
|
||||||
|
{
|
||||||
|
printf '# %s\n' "$MCA_PRETTY"
|
||||||
|
printf '#\n'
|
||||||
|
printf '# Written by `%s`. Nothing here needs editing by hand -\n' "$MCA_NAME"
|
||||||
|
printf '# every option is reachable from `%s` itself.\n' "$MCA_NAME"
|
||||||
|
} > "$MCA_CONFIG" || return 1
|
||||||
|
fi
|
||||||
|
[[ -w $MCA_CONFIG ]] || return 1
|
||||||
|
|
||||||
|
tmp="$(mktemp "${MCA_CONFIG}.XXXXXX")" || return 1
|
||||||
|
chmod --reference="$MCA_CONFIG" "$tmp" 2>/dev/null || chmod 0644 "$tmp"
|
||||||
|
|
||||||
|
if grep -qE "^[[:space:]]*#?[[:space:]]*${key}[[:space:]]*=" "$MCA_CONFIG"; then
|
||||||
|
awk -v key="$key" -v value="$value" '
|
||||||
|
!done && $0 ~ "^[[:space:]]*#?[[:space:]]*" key "[[:space:]]*=" {
|
||||||
|
print key "=" value; done = 1; next
|
||||||
|
}
|
||||||
|
# drop any further occurrences so the file cannot grow duplicates
|
||||||
|
$0 ~ "^[[:space:]]*" key "[[:space:]]*=" { next }
|
||||||
|
{ print }
|
||||||
|
' "$MCA_CONFIG" > "$tmp" || { rm -f "$tmp"; return 1; }
|
||||||
|
else
|
||||||
|
cat "$MCA_CONFIG" > "$tmp" || { rm -f "$tmp"; return 1; }
|
||||||
|
printf '%s=%s\n' "$key" "$value" >> "$tmp"
|
||||||
|
fi
|
||||||
|
|
||||||
|
mv -f "$tmp" "$MCA_CONFIG"
|
||||||
|
MCA_CONFIG_CACHED=0
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_config_list_has <Key> <item>
|
||||||
|
# The per-application overrides are stored as space separated lists.
|
||||||
|
mca_config_list_has() {
|
||||||
|
local list item="$2" entry
|
||||||
|
list="$(mca_config_get "$1" '')"
|
||||||
|
for entry in $list; do
|
||||||
|
[[ $entry == "$item" ]] && return 0
|
||||||
|
done
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_config_list_add <Key> <item> / mca_config_list_del <Key> <item>
|
||||||
|
mca_config_list_add() {
|
||||||
|
local key="$1" item="$2" list
|
||||||
|
mca_config_list_has "$key" "$item" && return 0
|
||||||
|
list="$(mca_config_get "$key" '')"
|
||||||
|
mca_config_set "$key" "${list:+$list }$item"
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_config_list_del() {
|
||||||
|
local key="$1" item="$2" list entry out=''
|
||||||
|
list="$(mca_config_get "$key" '')"
|
||||||
|
for entry in $list; do
|
||||||
|
[[ $entry == "$item" ]] && continue
|
||||||
|
out="${out:+$out }$entry"
|
||||||
|
done
|
||||||
|
mca_config_set "$key" "$out"
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Resolved settings
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
mca_config_load() {
|
||||||
|
CFG_ENABLED=no; mca_config_bool Enabled no && CFG_ENABLED=yes
|
||||||
|
CFG_APPS=no; mca_config_bool PatchApps yes && CFG_APPS=yes
|
||||||
|
CFG_BROWSERS=no; mca_config_bool PatchBrowsers yes && CFG_BROWSERS=yes
|
||||||
|
CFG_FLATPAK=no; mca_config_bool PatchFlatpak yes && CFG_FLATPAK=yes
|
||||||
|
CFG_SNAP=no; mca_config_bool PatchSnap yes && CFG_SNAP=yes
|
||||||
|
CFG_AUTOSTART=no; mca_config_bool PatchAutostart yes && CFG_AUTOSTART=yes
|
||||||
|
CFG_STEAM=no; mca_config_bool PatchSteam yes && CFG_STEAM=yes
|
||||||
|
CFG_SPOTIFY=no; mca_config_bool PatchSpotify yes && CFG_SPOTIFY=yes
|
||||||
|
CFG_WATCH=no; mca_config_bool WatchNewApps yes && CFG_WATCH=yes
|
||||||
|
|
||||||
|
CFG_EXTRA_FLAGS="$(mca_config_get ExtraFlags '')"
|
||||||
|
|
||||||
|
# Applications the user turned on or off by hand on the applications
|
||||||
|
# screen, by desktop file id. Include wins over detection, Skip wins over
|
||||||
|
# everything.
|
||||||
|
CFG_INCLUDE="$(mca_config_get Include '')"
|
||||||
|
CFG_SKIP="$(mca_config_get Skip '')"
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_flags [kind]
|
||||||
|
# The full argument string that gets injected. Kept in one place so the flag
|
||||||
|
# file writer and the desktop entry writer cannot drift apart.
|
||||||
|
#
|
||||||
|
# A browser gets the flag that leaves it without a warning bar; everything else
|
||||||
|
# gets the one that works in every Chromium there is. See MCA_FLAG.
|
||||||
|
mca_flags() {
|
||||||
|
if [[ ${1:-app} == browser ]]; then
|
||||||
|
printf '%s' "$MCA_BROWSER_FLAG"
|
||||||
|
else
|
||||||
|
printf '%s' "$MCA_FLAG"
|
||||||
|
fi
|
||||||
|
[[ -n ${CFG_EXTRA_FLAGS:-} ]] && printf ' %s' "$CFG_EXTRA_FLAGS"
|
||||||
|
printf '\n'
|
||||||
|
}
|
||||||
@@ -0,0 +1,861 @@
|
|||||||
|
# shellcheck shell=bash
|
||||||
|
#
|
||||||
|
# Finding the applications and deciding which of them are Chromium underneath.
|
||||||
|
#
|
||||||
|
# The detection is deliberately conservative. A wrong "yes" appends an unknown
|
||||||
|
# argument to something that is not Chromium, and plenty of programs treat an
|
||||||
|
# unrecognised argument as a file name to open - so every rule here is a
|
||||||
|
# positive one, and anything that cannot be identified is reported as unknown
|
||||||
|
# rather than guessed at.
|
||||||
|
|
||||||
|
# Files that only ever sit next to a Chromium or Electron binary. Any single one
|
||||||
|
# is conclusive; together they cover both bundled Electron (app.asar, the
|
||||||
|
# swiftshader libraries) and plain CEF (libcef).
|
||||||
|
#
|
||||||
|
# Deliberately not in here: libEGL.so and libffmpeg.so. Chromium ships both, but
|
||||||
|
# so does the system - /usr/lib/libEGL.so exists on any machine with Mesa - and
|
||||||
|
# a marker that can be somebody else's file is not a marker.
|
||||||
|
MCA_MARKERS=(
|
||||||
|
chrome_crashpad_handler chrome-sandbox chrome_100_percent.pak
|
||||||
|
icudtl.dat v8_context_snapshot.bin snapshot_blob.bin resources.pak
|
||||||
|
libvk_swiftshader.so LICENSES.chromium.html libcef.so
|
||||||
|
)
|
||||||
|
|
||||||
|
# Shared directories, where a marker belongs to the system rather than to the
|
||||||
|
# program that happens to live there. An application ships its payload in a
|
||||||
|
# directory of its own; nothing unpacks Chromium straight into /usr/lib.
|
||||||
|
MCA_SYSTEM_DIRS=(
|
||||||
|
/ /bin /lib /lib32 /lib64 /sbin /usr /usr/bin /usr/lib /usr/lib32
|
||||||
|
/usr/lib64 /usr/libexec /usr/sbin /usr/local /usr/local/bin
|
||||||
|
/usr/local/lib /usr/local/libexec /opt
|
||||||
|
)
|
||||||
|
|
||||||
|
# The same thing for the layouts that put a machine triplet in the path.
|
||||||
|
# Debian and Ubuntu keep the shared libraries in /usr/lib/x86_64-linux-gnu
|
||||||
|
# rather than /usr/lib, so that directory is every bit as shared as /usr/lib is
|
||||||
|
# elsewhere and a marker sitting in it belongs to nobody in particular.
|
||||||
|
MCA_SYSTEM_DIR_GLOBS=(
|
||||||
|
'/usr/lib/*-linux-gnu*' '/usr/lib32/*-linux-gnu*'
|
||||||
|
'/usr/lib64/*-linux-gnu*' '/usr/local/lib/*-linux-gnu*'
|
||||||
|
)
|
||||||
|
|
||||||
|
# Where snapd mounts the installed snaps. /snap is the usual place and the one
|
||||||
|
# the shims point into; distributions that keep /snap free of a top-level
|
||||||
|
# directory use the second.
|
||||||
|
MCA_SNAP_DIRS=(/snap /var/lib/snapd/snap)
|
||||||
|
|
||||||
|
# Strings in a launcher script that mean it starts a Chromium or Electron
|
||||||
|
# process, for the wrappers whose command line is assembled out of variables and
|
||||||
|
# cannot be followed from the outside.
|
||||||
|
#
|
||||||
|
# Only strings that no other kind of program has a reason to contain. The word
|
||||||
|
# "chromium" on its own is not one of them: /usr/bin/xdg-open lists every
|
||||||
|
# browser it knows how to start, and that is not a browser.
|
||||||
|
#
|
||||||
|
# The flag file convention is one distribution's packaging habit and says
|
||||||
|
# nothing about the engine either, so it is not in here.
|
||||||
|
#
|
||||||
|
# CHROMIUM_FLAGS and CHROME_WRAPPER earn their place: they are the variables
|
||||||
|
# the Debian, Fedora and openSUSE Chromium wrappers and Google's own Chrome
|
||||||
|
# wrapper build their command line out of, and nothing else sets them.
|
||||||
|
MCA_SCRIPT_HINTS='ELECTRON_|app\.asar|chrome-sandbox|libcef|enable-blink-features|ozone-platform-hint|CHROMIUM_FLAGS|CHROME_WRAPPER|CHROME_VERSION_EXTRA'
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Desktop entries
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# Where Flatpak and snapd put the launchers they export. Both add these to
|
||||||
|
# XDG_DATA_DIRS themselves, through a file in /etc/profile.d - but only for a
|
||||||
|
# session that was started after they were installed, and only for a session
|
||||||
|
# manager that reads it at all. They are appended, after everything XDG names,
|
||||||
|
# so a directory that is already in the search path keeps its own position and
|
||||||
|
# the ones that were missing are still scanned.
|
||||||
|
mca_extra_desktop_dirs() {
|
||||||
|
printf '%s\n' \
|
||||||
|
"$MCA_XDG_DATA/flatpak/exports/share/applications" \
|
||||||
|
/var/lib/flatpak/exports/share/applications \
|
||||||
|
/var/lib/snapd/desktop/applications
|
||||||
|
}
|
||||||
|
|
||||||
|
# The directories a desktop entry can come from, most specific first - which is
|
||||||
|
# also XDG lookup order, so the first file found for an id is the one that is
|
||||||
|
# actually used.
|
||||||
|
mca_desktop_dirs() {
|
||||||
|
local dirs="${XDG_DATA_DIRS:-/usr/local/share:/usr/share}" d
|
||||||
|
local -A seen=()
|
||||||
|
|
||||||
|
while IFS= read -r d; do
|
||||||
|
[[ -n $d ]] || continue
|
||||||
|
d="${d%/}"
|
||||||
|
[[ -n ${seen[$d]+set} ]] && continue
|
||||||
|
seen[$d]=1
|
||||||
|
printf '%s\n' "$d"
|
||||||
|
done < <(
|
||||||
|
printf '%s\n' "$MCA_APPDIR"
|
||||||
|
while IFS= read -r -d: d; do
|
||||||
|
[[ -n $d ]] && printf '%s/applications\n' "${d%/}"
|
||||||
|
done <<< "${dirs}:"
|
||||||
|
mca_extra_desktop_dirs
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
# _mca_desktop_read <file>
|
||||||
|
# Every key the scan needs, in one pass and without a single fork. There are a
|
||||||
|
# couple of hundred desktop entries on an ordinary system, and doing this with
|
||||||
|
# one awk per key per file is the difference between a menu that redraws and a
|
||||||
|
# menu that pauses.
|
||||||
|
DE_TYPE='' DE_HIDDEN='' DE_EXEC='' DE_NAME='' DE_CATEGORIES='' DE_MIME='' DE_OURS=''
|
||||||
|
|
||||||
|
_mca_desktop_read() {
|
||||||
|
local file="$1" line ingroup=0
|
||||||
|
|
||||||
|
DE_TYPE=''; DE_HIDDEN=''; DE_EXEC=''; DE_NAME=''
|
||||||
|
DE_CATEGORIES=''; DE_MIME=''; DE_OURS=''
|
||||||
|
|
||||||
|
while IFS= read -r line || [[ -n $line ]]; do
|
||||||
|
case "$line" in
|
||||||
|
'[Desktop Entry]'*) ingroup=1; continue ;;
|
||||||
|
'['*) ingroup=0; continue ;;
|
||||||
|
esac
|
||||||
|
(( ingroup )) || continue
|
||||||
|
|
||||||
|
# Locale variants are Name[de]= and never match these patterns, which
|
||||||
|
# is what we want: the untranslated key is the identifying one.
|
||||||
|
case "$line" in
|
||||||
|
Exec=*) [[ -n $DE_EXEC ]] || DE_EXEC="${line#Exec=}" ;;
|
||||||
|
Name=*) [[ -n $DE_NAME ]] || DE_NAME="${line#Name=}" ;;
|
||||||
|
Type=*) DE_TYPE="${line#Type=}" ;;
|
||||||
|
Hidden=*) DE_HIDDEN="${line#Hidden=}" ;;
|
||||||
|
Categories=*) DE_CATEGORIES="${line#Categories=}" ;;
|
||||||
|
MimeType=*) DE_MIME="${line#MimeType=}" ;;
|
||||||
|
# Only a generated shadow. An entry we edited in place carries
|
||||||
|
# X-MCA-Patched and is still the application's real entry, so it
|
||||||
|
# has to stay in the scan.
|
||||||
|
X-MCA-Generated=*) DE_OURS=1 ;;
|
||||||
|
esac
|
||||||
|
done < "$file"
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_exec_program <exec line>
|
||||||
|
# The program a desktop entry actually starts: the first token that is not an
|
||||||
|
# environment prefix, resolved to an absolute path. The result is left in
|
||||||
|
# MCA_PROG rather than printed - the scan calls this for every desktop entry on
|
||||||
|
# the system, and a command substitution each time is a fork each time.
|
||||||
|
#
|
||||||
|
# Fails for entries this tool has no safe way to rewrite: anything routed
|
||||||
|
# through a shell, where the real program is inside a quoted string.
|
||||||
|
MCA_PROG=''
|
||||||
|
|
||||||
|
mca_exec_program() {
|
||||||
|
local line="$1" tok prog=''
|
||||||
|
local -a tokens
|
||||||
|
|
||||||
|
MCA_PROG=''
|
||||||
|
|
||||||
|
# Field codes are placeholders, not arguments, and quotes only ever wrap
|
||||||
|
# whole tokens here; splitting on whitespace is enough to find token one.
|
||||||
|
read -r -a tokens <<< "$line"
|
||||||
|
|
||||||
|
for tok in "${tokens[@]}"; do
|
||||||
|
tok="${tok%\"}"; tok="${tok#\"}"
|
||||||
|
tok="${tok%\'}"; tok="${tok#\'}"
|
||||||
|
[[ -z $tok ]] && continue
|
||||||
|
[[ $tok == *=* && $tok != /* ]] && continue # VAR=value prefix
|
||||||
|
[[ $tok == env ]] && continue
|
||||||
|
prog="$tok"
|
||||||
|
break
|
||||||
|
done
|
||||||
|
|
||||||
|
[[ -n $prog ]] || return 1
|
||||||
|
|
||||||
|
case "${prog##*/}" in
|
||||||
|
sh|bash|dash|zsh|fish) return 1 ;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
# PATH is searched here rather than with `command -v`, which is a builtin
|
||||||
|
# but would have to be read back through a command substitution, and that
|
||||||
|
# is a fork per desktop entry.
|
||||||
|
if [[ $prog != /* ]]; then
|
||||||
|
local d found=''
|
||||||
|
local -a pathdirs
|
||||||
|
IFS=: read -r -a pathdirs <<< "$PATH"
|
||||||
|
for d in "${pathdirs[@]}"; do
|
||||||
|
[[ -n $d ]] || continue
|
||||||
|
if [[ -x "$d/$prog" && ! -d "$d/$prog" ]]; then found="$d/$prog"; break; fi
|
||||||
|
done
|
||||||
|
[[ -n $found ]] || return 1
|
||||||
|
prog="$found"
|
||||||
|
fi
|
||||||
|
|
||||||
|
MCA_PROG="$prog"
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_exec_flatpak_id <exec line>
|
||||||
|
# The application id out of a `flatpak run ...` command line, in MCA_PROG.
|
||||||
|
mca_exec_flatpak_id() {
|
||||||
|
local line="$1" tok seen_run=0
|
||||||
|
local -a tokens
|
||||||
|
read -r -a tokens <<< "$line"
|
||||||
|
|
||||||
|
MCA_PROG=''
|
||||||
|
for tok in "${tokens[@]}"; do
|
||||||
|
if (( ! seen_run )); then
|
||||||
|
[[ $tok == run ]] && seen_run=1
|
||||||
|
continue
|
||||||
|
fi
|
||||||
|
[[ $tok == -* || $tok == @@* || $tok == %* ]] && continue
|
||||||
|
[[ $tok == *.*.* ]] || continue
|
||||||
|
MCA_PROG="$tok"
|
||||||
|
return 0
|
||||||
|
done
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_exec_is_steam_link <exec line> <program>
|
||||||
|
# Whether an entry starts something inside Steam rather than starting Steam
|
||||||
|
# itself: it carries a steam:// address of its own. Steam writes one of those
|
||||||
|
# for every game somebody asks for a shortcut to, and the client's own entry
|
||||||
|
# never has one - it takes an address from the outside, through %U.
|
||||||
|
mca_exec_is_steam_link() {
|
||||||
|
local line="$1" prog="$2"
|
||||||
|
|
||||||
|
[[ $line == *steam://* ]] || return 1
|
||||||
|
mca_prog_is_steam "$prog"
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_prog_is_steam <program>
|
||||||
|
# Whether running this program starts the Steam client. Every packaging is in
|
||||||
|
# here and every name Valve and the distributions give the launcher, because
|
||||||
|
# the answer decides whether an entry gets Steam's own switch - and an entry
|
||||||
|
# that starts Steam without it undoes the web helper patch on the way up.
|
||||||
|
#
|
||||||
|
# The program is what a scan leaves behind: an absolute path for a native
|
||||||
|
# install, flatpak:<id> or snap:<name> for the other two.
|
||||||
|
mca_prog_is_steam() {
|
||||||
|
local prog="$1"
|
||||||
|
|
||||||
|
case "${prog##*/}" in
|
||||||
|
steam|steam-runtime|steam-native|steam-jupiter) return 0 ;;
|
||||||
|
esac
|
||||||
|
[[ $prog == flatpak:com.valvesoftware.Steam || $prog == snap:steam ]]
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Is this Chromium?
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# Answers are cached against size and mtime, because the systemd path unit can
|
||||||
|
# fire several times in a row while a package installs and each miss costs a
|
||||||
|
# scan of a 200 MB binary.
|
||||||
|
#
|
||||||
|
# The file is read once into memory rather than searched per lookup: a scan
|
||||||
|
# asks about every program on the system, and an awk per question is most of
|
||||||
|
# the time the scan takes.
|
||||||
|
declare -A MCA_DETECT_MEMO=()
|
||||||
|
declare -A MCA_DETECT_CACHE=()
|
||||||
|
MCA_CACHE_LOADED=0
|
||||||
|
MCA_CACHE_DIRTY=0
|
||||||
|
|
||||||
|
# Size and mtime for every program the scan is about to ask about, collected in
|
||||||
|
# one call. Checking a cache entry is still stale needs a stat, and one stat per
|
||||||
|
# program on the system was most of what a warm scan spent its time on.
|
||||||
|
declare -A MCA_STAT=()
|
||||||
|
|
||||||
|
_mca_stat_batch() {
|
||||||
|
local name st
|
||||||
|
(( $# )) || return 0
|
||||||
|
while IFS=$'\t' read -r name st; do
|
||||||
|
[[ -n $name ]] && MCA_STAT["$name"]="$st"
|
||||||
|
done < <(stat -Lc '%n %s:%Y' -- "$@" 2>/dev/null)
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
_mca_cache_load() {
|
||||||
|
local path stamp verdict
|
||||||
|
|
||||||
|
(( MCA_CACHE_LOADED )) && return 0
|
||||||
|
MCA_CACHE_LOADED=1
|
||||||
|
|
||||||
|
[[ -r "$MCA_CACHEDIR/detect" ]] || return 0
|
||||||
|
while IFS=$'\t' read -r path stamp verdict; do
|
||||||
|
[[ -n $path && -n $stamp ]] || continue
|
||||||
|
MCA_DETECT_CACHE["$path"]="$stamp"$'\t'"$verdict"
|
||||||
|
done < "$MCA_CACHEDIR/detect"
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# Written back once, at exit, instead of after every miss.
|
||||||
|
mca_cache_flush() {
|
||||||
|
local path entry tmp
|
||||||
|
|
||||||
|
(( MCA_CACHE_DIRTY )) || return 0
|
||||||
|
mkdir -p "$MCA_CACHEDIR" 2>/dev/null || return 0
|
||||||
|
|
||||||
|
tmp="$(mktemp "$MCA_CACHEDIR/detect.XXXXXX")" || return 0
|
||||||
|
for path in "${!MCA_DETECT_CACHE[@]}"; do
|
||||||
|
entry="${MCA_DETECT_CACHE[$path]}"
|
||||||
|
printf '%s\t%s\n' "$path" "$entry" >> "$tmp"
|
||||||
|
done
|
||||||
|
mv -f "$tmp" "$MCA_CACHEDIR/detect" 2>/dev/null || rm -f "$tmp"
|
||||||
|
MCA_CACHE_DIRTY=0
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# _mca_has_markers <directory>
|
||||||
|
_mca_has_markers() {
|
||||||
|
local dir="$1" m s
|
||||||
|
|
||||||
|
[[ -d $dir ]] || return 1
|
||||||
|
dir="${dir%/}"
|
||||||
|
for s in "${MCA_SYSTEM_DIRS[@]}"; do
|
||||||
|
[[ $dir == "$s" ]] && return 1
|
||||||
|
done
|
||||||
|
for s in "${MCA_SYSTEM_DIR_GLOBS[@]}"; do
|
||||||
|
# Unquoted on purpose - these are patterns, not names.
|
||||||
|
# shellcheck disable=SC2053
|
||||||
|
[[ $dir == $s ]] && return 1
|
||||||
|
done
|
||||||
|
|
||||||
|
for m in "${MCA_MARKERS[@]}"; do
|
||||||
|
[[ -e "$dir/$m" ]] && return 0
|
||||||
|
done
|
||||||
|
[[ -e "$dir/resources/app.asar" || -e "$dir/app.asar" ]] && return 0
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
# The plain assignments the script made before it handed over, for
|
||||||
|
# _mca_script_subst to read. A variable of its own rather than something passed
|
||||||
|
# around: every caller of _mca_script_target reads it through a command
|
||||||
|
# substitution, so each call already works on a copy and there is nothing here
|
||||||
|
# that two of them could collide over.
|
||||||
|
declare -A MCA_SCRIPT_VARS=()
|
||||||
|
|
||||||
|
# _mca_script_subst <text>
|
||||||
|
# The text with $NAME and ${NAME} replaced by what the script assigned to them,
|
||||||
|
# left in MCA_SUBST.
|
||||||
|
#
|
||||||
|
# Fails as soon as something turns up that only a running shell could work out
|
||||||
|
# - a positional parameter, a name the script never set, a default value. That
|
||||||
|
# is the point: an unresolvable path has to come out as no path at all, never
|
||||||
|
# as a wrong one.
|
||||||
|
MCA_SUBST=''
|
||||||
|
|
||||||
|
_mca_script_subst() {
|
||||||
|
local text="$1" out='' rest name
|
||||||
|
|
||||||
|
while [[ $text == *'$'* ]]; do
|
||||||
|
out+="${text%%\$*}"
|
||||||
|
rest="${text#*\$}"
|
||||||
|
|
||||||
|
if [[ $rest == '{'* ]]; then
|
||||||
|
[[ $rest == *'}'* ]] || return 1
|
||||||
|
name="${rest%%\}*}"; name="${name#\{}"
|
||||||
|
rest="${rest#*\}}"
|
||||||
|
else
|
||||||
|
name="${rest%%[!A-Za-z0-9_]*}"
|
||||||
|
rest="${rest:${#name}}"
|
||||||
|
fi
|
||||||
|
|
||||||
|
[[ $name =~ ^[A-Za-z_][A-Za-z0-9_]*$ ]] || return 1
|
||||||
|
[[ -n ${MCA_SCRIPT_VARS[$name]+set} ]] || return 1
|
||||||
|
|
||||||
|
out+="${MCA_SCRIPT_VARS[$name]}"
|
||||||
|
text="$rest"
|
||||||
|
done
|
||||||
|
|
||||||
|
MCA_SUBST="$out$text"
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# _mca_script_target <script>
|
||||||
|
# The program a wrapper script hands over to, so a chain like
|
||||||
|
# heroic -> electron43 -> /usr/lib/electron43/electron can be followed.
|
||||||
|
#
|
||||||
|
# The assignments above the exec line are followed as well, because that is the
|
||||||
|
# shape the Chromium wrappers outside Arch have: Debian, Ubuntu, Fedora and
|
||||||
|
# openSUSE all set the directory and the program name into variables at the top
|
||||||
|
# of the script and end on `exec -a "$APPNAME" "$LIBDIR/$APPNAME"`. Without
|
||||||
|
# resolving those there is nothing to follow, and the answer would have to come
|
||||||
|
# from the hint scan - a weaker kind of evidence than finding the binary and
|
||||||
|
# its markers.
|
||||||
|
_mca_script_target() {
|
||||||
|
local script="$1" line tok name val skip=0
|
||||||
|
local -a tokens
|
||||||
|
local re_assign='^[[:space:]]*(export[[:space:]]+)?([A-Za-z_][A-Za-z0-9_]*)=([^[:space:];|&()`]*)[[:space:]]*$'
|
||||||
|
|
||||||
|
MCA_SCRIPT_VARS=()
|
||||||
|
|
||||||
|
while IFS= read -r line; do
|
||||||
|
if [[ $line =~ $re_assign ]]; then
|
||||||
|
name="${BASH_REMATCH[2]}"
|
||||||
|
val="${BASH_REMATCH[3]}"
|
||||||
|
|
||||||
|
# One pair of quotes around the whole value is ordinary and means
|
||||||
|
# nothing here. Single quotes also mean the value is literal, so
|
||||||
|
# there is nothing left to expand.
|
||||||
|
if [[ $val == \'*\' ]]; then
|
||||||
|
MCA_SCRIPT_VARS[$name]="${val:1:${#val}-2}"
|
||||||
|
continue
|
||||||
|
fi
|
||||||
|
[[ $val == \"*\" ]] && val="${val:1:${#val}-2}"
|
||||||
|
|
||||||
|
if _mca_script_subst "$val"; then
|
||||||
|
MCA_SCRIPT_VARS[$name]="$MCA_SUBST"
|
||||||
|
else
|
||||||
|
# Not resolvable, so anything built from it must not be either.
|
||||||
|
unset "MCA_SCRIPT_VARS[$name]"
|
||||||
|
fi
|
||||||
|
continue
|
||||||
|
fi
|
||||||
|
|
||||||
|
[[ $line =~ ^[[:space:]]*exec[[:space:]]+(.*)$ ]] || continue
|
||||||
|
read -r -a tokens <<< "${BASH_REMATCH[1]}"
|
||||||
|
skip=0
|
||||||
|
for tok in "${tokens[@]}"; do
|
||||||
|
(( skip )) && { skip=0; continue; }
|
||||||
|
case "$tok" in
|
||||||
|
env) continue ;;
|
||||||
|
# `exec -a NAME PROG` renames the process. NAME is not a
|
||||||
|
# program, and it is usually the wrapper's own name, so
|
||||||
|
# following it would lead straight back here.
|
||||||
|
-a|--argv0) skip=1; continue ;;
|
||||||
|
-*) continue ;;
|
||||||
|
esac
|
||||||
|
[[ $tok == *=* && $tok != /* ]] && continue
|
||||||
|
|
||||||
|
tok="${tok%\"}"; tok="${tok#\"}"
|
||||||
|
tok="${tok%\'}"; tok="${tok#\'}"
|
||||||
|
|
||||||
|
# Anything still carrying a shell variable is resolved from the
|
||||||
|
# assignments above, or not at all; the hint scan answers for the
|
||||||
|
# wrappers that build their command line some other way.
|
||||||
|
if [[ $tok == *'$'* ]]; then
|
||||||
|
_mca_script_subst "$tok" || return 1
|
||||||
|
tok="$MCA_SUBST"
|
||||||
|
fi
|
||||||
|
[[ -n $tok ]] || return 1
|
||||||
|
|
||||||
|
if [[ $tok == /* ]]; then
|
||||||
|
printf '%s\n' "$tok"
|
||||||
|
else
|
||||||
|
command -v "$tok" 2>/dev/null
|
||||||
|
fi
|
||||||
|
return $?
|
||||||
|
done
|
||||||
|
done < "$script"
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_flags_candidates <program>
|
||||||
|
# The flag files a launcher reads, in the order it reads them, taken from the
|
||||||
|
# launcher itself rather than assumed from the distribution. Where the wrappers
|
||||||
|
# follow that convention - Arch's Electron and Chromium packages do, and take
|
||||||
|
# extra arguments from $XDG_CONFIG_HOME/<name>-flags.conf - it is a far better
|
||||||
|
# place to inject than a desktop entry: it survives package updates and it
|
||||||
|
# applies to a launch from the terminal too. Where they do not, this finds
|
||||||
|
# nothing and the caller falls back to the desktop entry.
|
||||||
|
mca_flags_candidates() {
|
||||||
|
local prog="$1" depth="${2:-0}" target inherited
|
||||||
|
(( depth > 3 )) && return 0
|
||||||
|
[[ -r $prog ]] || return 0
|
||||||
|
head -c2 -- "$prog" 2>/dev/null | grep -q '#!' || return 0
|
||||||
|
|
||||||
|
grep -oE '[A-Za-z0-9_.+-]+-flags\.conf' -- "$prog" 2>/dev/null
|
||||||
|
|
||||||
|
# A wrapper that only execs another wrapper (heroic -> electron43) inherits
|
||||||
|
# that one's flag files, plus the specific name it builds from a variable
|
||||||
|
# at runtime and therefore never writes down - which is why that one is
|
||||||
|
# derived from the target's own name rather than found.
|
||||||
|
#
|
||||||
|
# It is derived only once the target has shown that it reads a flag file at
|
||||||
|
# all. Every launcher that can be followed is not a launcher that reads
|
||||||
|
# one: the Chromium wrappers outside Arch do not, and neither does an
|
||||||
|
# ordinary program that simply execs its own binary. Naming a file for
|
||||||
|
# those would put the flag somewhere nothing ever looks and skip the
|
||||||
|
# desktop entry that would have worked.
|
||||||
|
if target="$(_mca_script_target "$prog")" && [[ -n $target ]]; then
|
||||||
|
inherited="$(mca_flags_candidates "$target" $(( depth + 1 )))"
|
||||||
|
if [[ -n $inherited ]]; then
|
||||||
|
printf '%s-flags.conf\n' "${target##*/}"
|
||||||
|
printf '%s\n' "$inherited"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_is_chromium <program>
|
||||||
|
# Succeeds when the program is a Chromium, CEF or Electron process.
|
||||||
|
mca_is_chromium() {
|
||||||
|
local prog="$1" verdict real stamp cached
|
||||||
|
|
||||||
|
[[ -n $prog && -e $prog ]] || return 1
|
||||||
|
|
||||||
|
# Memoized under the path as given, so the same launcher named twice in a
|
||||||
|
# scan costs nothing at all the second time.
|
||||||
|
if [[ -n ${MCA_DETECT_MEMO[$prog]+set} ]]; then
|
||||||
|
[[ ${MCA_DETECT_MEMO[$prog]} == yes ]]
|
||||||
|
return $?
|
||||||
|
fi
|
||||||
|
|
||||||
|
_mca_cache_load
|
||||||
|
|
||||||
|
if [[ -n ${MCA_STAT[$prog]+set} ]]; then
|
||||||
|
stamp="${MCA_STAT[$prog]}"
|
||||||
|
else
|
||||||
|
stamp="$(stat -Lc '%s:%Y' -- "$prog" 2>/dev/null)" || stamp=''
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [[ -n $stamp && -n ${MCA_DETECT_CACHE[$prog]+set} ]]; then
|
||||||
|
cached="${MCA_DETECT_CACHE[$prog]}"
|
||||||
|
if [[ "${cached%%$'\t'*}" == "$stamp" ]]; then
|
||||||
|
verdict="${cached#*$'\t'}"
|
||||||
|
MCA_DETECT_MEMO[$prog]="$verdict"
|
||||||
|
[[ $verdict == yes ]]
|
||||||
|
return $?
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
real="$(readlink -f -- "$prog" 2>/dev/null)" || real="$prog"
|
||||||
|
|
||||||
|
verdict=no
|
||||||
|
if _mca_detect_uncached "$real"; then verdict=yes; fi
|
||||||
|
|
||||||
|
MCA_DETECT_MEMO[$prog]="$verdict"
|
||||||
|
if [[ -n $stamp ]]; then
|
||||||
|
MCA_DETECT_CACHE["$prog"]="$stamp"$'\t'"$verdict"
|
||||||
|
MCA_CACHE_DIRTY=1
|
||||||
|
fi
|
||||||
|
[[ $verdict == yes ]]
|
||||||
|
}
|
||||||
|
|
||||||
|
_mca_detect_uncached() {
|
||||||
|
local real="$1" depth="${2:-0}" dir target
|
||||||
|
|
||||||
|
(( depth > 3 )) && return 1
|
||||||
|
[[ -r $real ]] || return 1
|
||||||
|
|
||||||
|
if head -c2 -- "$real" 2>/dev/null | grep -q '#!'; then
|
||||||
|
# A launcher script. Following where it hands over is the reliable
|
||||||
|
# answer; the hint scan catches the ones that build the command line
|
||||||
|
# out of variables (vesktop, discord and most vendor wrappers).
|
||||||
|
if target="$(_mca_script_target "$real")" && [[ -n $target ]]; then
|
||||||
|
_mca_detect_uncached "$(readlink -f -- "$target" 2>/dev/null || printf '%s' "$target")" \
|
||||||
|
$(( depth + 1 )) && return 0
|
||||||
|
fi
|
||||||
|
grep -qE "$MCA_SCRIPT_HINTS" -- "$real" 2>/dev/null && return 0
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# A binary. Everything Chromium ships is unpacked next to it, either in the
|
||||||
|
# same directory or - for /opt/thing/bin/Thing layouts - one level up.
|
||||||
|
dir="$(dirname -- "$real")"
|
||||||
|
_mca_has_markers "$dir" && return 0
|
||||||
|
[[ ${dir##*/} == bin ]] && _mca_has_markers "${dir%/*}" && return 0
|
||||||
|
|
||||||
|
# Last resort: Chromium's own argument table is in the binary. -m1 stops at
|
||||||
|
# the first hit, so this reads far less than the file size suggests.
|
||||||
|
#
|
||||||
|
# AppImages are the one thing this cannot see through - their payload is a
|
||||||
|
# compressed filesystem - which is why they come out as unknown and are
|
||||||
|
# left to the applications screen.
|
||||||
|
grep -qaFm1 -- 'enable-blink-features' "$real" 2>/dev/null && return 0
|
||||||
|
grep -qaFm1 -- 'CHROME_VERSION_EXTRA' "$real" 2>/dev/null && return 0
|
||||||
|
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# The scan
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Results land in parallel arrays rather than being printed, so the caller can
|
||||||
|
# use them for both patching and the applications screen without scanning twice.
|
||||||
|
|
||||||
|
MCA_IDS=() # desktop file id, without the .desktop suffix
|
||||||
|
MCA_FILES=() # the desktop entry that is in effect for that id
|
||||||
|
MCA_NAMES=() # display name
|
||||||
|
MCA_PROGS=() # resolved program, or a Flatpak app id or a snap name
|
||||||
|
MCA_KINDS=() # app | browser | steam | unknown | no
|
||||||
|
MCA_PACKAGING=() # native | flatpak | snap
|
||||||
|
|
||||||
|
# The shortcuts Steam writes for single games. Not applications of their own - a
|
||||||
|
# game is whatever engine it was built with, and none of those reads a Chromium
|
||||||
|
# argument - so they are kept apart from the list rather than listed as
|
||||||
|
# something that got switched on. They do start Steam, which is why they are
|
||||||
|
# kept at all: the Steam module gives them Steam's own switch.
|
||||||
|
MCA_STEAM_LINKS=() # desktop file id
|
||||||
|
MCA_STEAM_LINK_FILES=() # the entry that is in effect for it
|
||||||
|
MCA_STEAM_LINK_PACK=() # native | flatpak | snap, which decides where the
|
||||||
|
# switch goes on the command line
|
||||||
|
|
||||||
|
# A scan reads every desktop entry on the system, so the menu does it once and
|
||||||
|
# then redraws from what it found. Applying rescans on its own, so nothing else
|
||||||
|
# has to remember to invalidate this.
|
||||||
|
MCA_SCANNED=0
|
||||||
|
|
||||||
|
mca_scan_once() {
|
||||||
|
(( MCA_SCANNED )) && return 0
|
||||||
|
mca_scan
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_scan() {
|
||||||
|
local dir file id name exec_line prog kind packaging i
|
||||||
|
local -A seen=()
|
||||||
|
local -a c_ids=() c_files=() c_names=() c_progs=() c_browser=() c_stat=()
|
||||||
|
|
||||||
|
MCA_IDS=(); MCA_FILES=(); MCA_NAMES=(); MCA_PROGS=(); MCA_KINDS=()
|
||||||
|
MCA_PACKAGING=()
|
||||||
|
MCA_STEAM_LINKS=(); MCA_STEAM_LINK_FILES=(); MCA_STEAM_LINK_PACK=()
|
||||||
|
|
||||||
|
# Pass one: read the entries and work out what each of them starts. No
|
||||||
|
# detection yet - that needs a stat per program, and those are collected so
|
||||||
|
# they can be asked for all at once.
|
||||||
|
while IFS= read -r dir; do
|
||||||
|
[[ -d $dir ]] || continue
|
||||||
|
for file in "$dir"/*.desktop; do
|
||||||
|
[[ -f $file ]] || continue
|
||||||
|
|
||||||
|
id="${file##*/}"; id="${id%.desktop}"
|
||||||
|
[[ -n ${seen[$id]+set} ]] && continue
|
||||||
|
seen[$id]=1
|
||||||
|
|
||||||
|
_mca_desktop_read "$file"
|
||||||
|
|
||||||
|
# One of our own generated entries. It describes the same
|
||||||
|
# application as the system one it shadows, so it is skipped and
|
||||||
|
# the id left free for the original further down the search path.
|
||||||
|
[[ -n $DE_OURS ]] && { unset "seen[$id]"; continue; }
|
||||||
|
|
||||||
|
[[ $DE_TYPE == Application ]] || continue
|
||||||
|
[[ $DE_HIDDEN == true ]] && continue
|
||||||
|
|
||||||
|
exec_line="$DE_EXEC"
|
||||||
|
[[ -n $exec_line ]] || continue
|
||||||
|
|
||||||
|
name="$DE_NAME"
|
||||||
|
[[ -n $name ]] || name="$id"
|
||||||
|
|
||||||
|
mca_exec_program "$exec_line" || continue
|
||||||
|
prog="$MCA_PROG"
|
||||||
|
|
||||||
|
if [[ ${prog##*/} == flatpak ]]; then
|
||||||
|
mca_exec_flatpak_id "$exec_line" || continue
|
||||||
|
prog="flatpak:$MCA_PROG"
|
||||||
|
elif mca_snap_name "$prog"; then
|
||||||
|
prog="snap:$MCA_PROG"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if mca_exec_is_steam_link "$exec_line" "$prog"; then
|
||||||
|
MCA_STEAM_LINKS+=("$id")
|
||||||
|
MCA_STEAM_LINK_FILES+=("$file")
|
||||||
|
if [[ $prog == flatpak:* ]]; then
|
||||||
|
MCA_STEAM_LINK_PACK+=(flatpak)
|
||||||
|
elif [[ $prog == snap:* ]]; then
|
||||||
|
MCA_STEAM_LINK_PACK+=(snap)
|
||||||
|
else
|
||||||
|
MCA_STEAM_LINK_PACK+=(native)
|
||||||
|
fi
|
||||||
|
continue
|
||||||
|
fi
|
||||||
|
|
||||||
|
c_ids+=("$id"); c_files+=("$file"); c_names+=("$name")
|
||||||
|
c_progs+=("$prog")
|
||||||
|
if mca_desktop_is_browser; then c_browser+=(1); else c_browser+=(0); fi
|
||||||
|
[[ $prog == /* ]] && c_stat+=("$prog")
|
||||||
|
done
|
||||||
|
done < <(mca_desktop_dirs)
|
||||||
|
|
||||||
|
MCA_STAT=()
|
||||||
|
_mca_stat_batch "${c_stat[@]}"
|
||||||
|
|
||||||
|
# Pass two: decide what each one is. What it does - an application or a
|
||||||
|
# browser - and how it was packaged are two separate questions: a Chromium
|
||||||
|
# installed as a snap is still a browser, and somebody who has turned
|
||||||
|
# browsers off means that one too.
|
||||||
|
for i in "${!c_ids[@]}"; do
|
||||||
|
prog="${c_progs[i]}"
|
||||||
|
kind=no
|
||||||
|
packaging=native
|
||||||
|
|
||||||
|
if [[ $prog == flatpak:* ]]; then
|
||||||
|
packaging=flatpak
|
||||||
|
if mca_prog_is_steam "$prog"; then
|
||||||
|
kind=steam
|
||||||
|
elif mca_flatpak_is_chromium "${prog#flatpak:}"; then
|
||||||
|
(( c_browser[i] )) && kind=browser || kind=app
|
||||||
|
fi
|
||||||
|
prog="${prog#flatpak:}"
|
||||||
|
elif [[ $prog == snap:* ]]; then
|
||||||
|
prog="${prog#snap:}"
|
||||||
|
packaging=snap
|
||||||
|
if [[ $prog == steam ]]; then
|
||||||
|
kind=steam
|
||||||
|
elif mca_snap_is_chromium "$prog"; then
|
||||||
|
(( c_browser[i] )) && kind=browser || kind=app
|
||||||
|
fi
|
||||||
|
elif mca_prog_is_steam "$prog"; then
|
||||||
|
# Steam is Chromium inside, but nothing about it can be changed
|
||||||
|
# from a command line argument; it has its own module.
|
||||||
|
kind=steam
|
||||||
|
elif mca_is_chromium "$prog"; then
|
||||||
|
(( c_browser[i] )) && kind=browser || kind=app
|
||||||
|
elif [[ $prog == *.AppImage || $prog == *.appimage ]]; then
|
||||||
|
kind=unknown
|
||||||
|
fi
|
||||||
|
|
||||||
|
[[ $kind == no ]] && continue
|
||||||
|
|
||||||
|
MCA_IDS+=("${c_ids[i]}")
|
||||||
|
MCA_FILES+=("${c_files[i]}")
|
||||||
|
MCA_NAMES+=("${c_names[i]}")
|
||||||
|
MCA_PROGS+=("$prog")
|
||||||
|
MCA_KINDS+=("$kind")
|
||||||
|
MCA_PACKAGING+=("$packaging")
|
||||||
|
done
|
||||||
|
|
||||||
|
mca_cache_flush
|
||||||
|
MCA_SCANNED=1
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_has_flags_file <program>
|
||||||
|
# Whether the program's launcher reads a flag file. Memoized: the status block
|
||||||
|
# asks this for every application it lists, and answering it means reading the
|
||||||
|
# launcher script.
|
||||||
|
declare -A MCA_FLAGS_MEMO=()
|
||||||
|
|
||||||
|
mca_has_flags_file() {
|
||||||
|
local prog="$1"
|
||||||
|
|
||||||
|
if [[ -z ${MCA_FLAGS_MEMO[$prog]+set} ]]; then
|
||||||
|
if [[ -n "$(mca_flags_candidates "$prog")" ]]; then
|
||||||
|
MCA_FLAGS_MEMO[$prog]=yes
|
||||||
|
else
|
||||||
|
MCA_FLAGS_MEMO[$prog]=no
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
[[ ${MCA_FLAGS_MEMO[$prog]} == yes ]]
|
||||||
|
}
|
||||||
|
|
||||||
|
# A browser is anything that offers itself for http. That is the property that
|
||||||
|
# matters here: those are the applications where middle click currently pastes
|
||||||
|
# a URL, so a user may well want them left alone.
|
||||||
|
#
|
||||||
|
# Reads the keys _mca_desktop_read left behind, so it only makes sense straight
|
||||||
|
# after that call.
|
||||||
|
mca_desktop_is_browser() {
|
||||||
|
[[ $DE_CATEGORIES == *WebBrowser* ]] && return 0
|
||||||
|
[[ $DE_MIME == *x-scheme-handler/http* ]] && return 0
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_snap_name <program>
|
||||||
|
# The snap an executable belongs to, left in MCA_PROG - assigned rather than
|
||||||
|
# printed for the same reason mca_exec_program is: the scan asks this about
|
||||||
|
# every desktop entry on the system, and a command substitution per entry is a
|
||||||
|
# fork per entry.
|
||||||
|
#
|
||||||
|
# /snap/bin/<name> is the shim snapd puts in PATH and is a symlink to snapd
|
||||||
|
# itself, so following it lands on /usr/bin/snap and says nothing whatever
|
||||||
|
# about the application. The name is the only thing that carries information,
|
||||||
|
# and it is what leads to the mounted tree below.
|
||||||
|
mca_snap_name() {
|
||||||
|
local prog="$1" rest d
|
||||||
|
|
||||||
|
for d in "${MCA_SNAP_DIRS[@]}"; do
|
||||||
|
if [[ $prog == "$d/bin/"* ]]; then
|
||||||
|
rest="${prog#"$d/bin/"}"
|
||||||
|
# A snap that ships several programs names them <snap>.<app>.
|
||||||
|
MCA_PROG="${rest%%.*}"
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
if [[ $prog == "$d/"* ]]; then
|
||||||
|
rest="${prog#"$d/"}"
|
||||||
|
MCA_PROG="${rest%%/*}"
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_snap_is_chromium <snap name>
|
||||||
|
# A snap keeps everything it ships inside its own mounted revision, so the
|
||||||
|
# marker check works the same way there as anywhere else once that tree has
|
||||||
|
# been located. "current" is the symlink snapd keeps pointing at the revision
|
||||||
|
# that will actually be started.
|
||||||
|
mca_snap_is_chromium() {
|
||||||
|
local name="$1" d root
|
||||||
|
|
||||||
|
if [[ -n ${MCA_DETECT_MEMO[snap:$name]+set} ]]; then
|
||||||
|
[[ ${MCA_DETECT_MEMO[snap:$name]} == yes ]]
|
||||||
|
return $?
|
||||||
|
fi
|
||||||
|
|
||||||
|
for d in "${MCA_SNAP_DIRS[@]}"; do
|
||||||
|
root="$d/$name/current"
|
||||||
|
[[ -d $root ]] || continue
|
||||||
|
if [[ -n "$(find "$root" -maxdepth 5 \
|
||||||
|
\( -name 'chrome_crashpad_handler' -o -name 'app.asar' \
|
||||||
|
-o -name 'libcef.so' -o -name 'v8_context_snapshot.bin' \
|
||||||
|
-o -name 'chrome-sandbox' \) \
|
||||||
|
-print -quit 2>/dev/null)" ]]
|
||||||
|
then
|
||||||
|
MCA_DETECT_MEMO[snap:$name]=yes
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
MCA_DETECT_MEMO[snap:$name]=no
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_flatpak_is_chromium <app id>
|
||||||
|
# Flatpak keeps every application in its own tree, so the marker check works the
|
||||||
|
# same way once that tree has been located.
|
||||||
|
mca_flatpak_is_chromium() {
|
||||||
|
local id="$1" loc
|
||||||
|
mca_have flatpak || return 1
|
||||||
|
|
||||||
|
if [[ -n ${MCA_DETECT_MEMO[flatpak:$id]+set} ]]; then
|
||||||
|
[[ ${MCA_DETECT_MEMO[flatpak:$id]} == yes ]]
|
||||||
|
return $?
|
||||||
|
fi
|
||||||
|
|
||||||
|
loc="$(flatpak info --show-location "$id" 2>/dev/null)"
|
||||||
|
if [[ -n $loc && -d "$loc/files" ]] \
|
||||||
|
&& [[ -n "$(find "$loc/files" -maxdepth 4 \
|
||||||
|
\( -name 'chrome_crashpad_handler' -o -name 'app.asar' \
|
||||||
|
-o -name 'libcef.so' -o -name 'v8_context_snapshot.bin' \) \
|
||||||
|
-print -quit 2>/dev/null)" ]]
|
||||||
|
then
|
||||||
|
MCA_DETECT_MEMO[flatpak:$id]=yes
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
MCA_DETECT_MEMO[flatpak:$id]=no
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_kind_wanted <kind> <id> [packaging]
|
||||||
|
# Whether the current settings say this entry should be patched. Skip beats
|
||||||
|
# everything, an explicit include beats detection, and detection beats nothing.
|
||||||
|
#
|
||||||
|
# Packaging is a gate in front of the category rather than a category of its
|
||||||
|
# own: a Flatpak or a snap sees none of the host's configuration and is worth
|
||||||
|
# switching off as a group, but it is still an application or a browser and
|
||||||
|
# whichever of those the user turned off applies to it too.
|
||||||
|
mca_kind_wanted() {
|
||||||
|
local kind="$1" id="$2" packaging="${3:-native}"
|
||||||
|
|
||||||
|
mca_config_list_has Skip "$id" && return 1
|
||||||
|
mca_config_list_has Include "$id" && return 0
|
||||||
|
|
||||||
|
case "$packaging" in
|
||||||
|
flatpak) [[ $CFG_FLATPAK == yes ]] || return 1 ;;
|
||||||
|
snap) [[ $CFG_SNAP == yes ]] || return 1 ;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
case "$kind" in
|
||||||
|
app) [[ $CFG_APPS == yes ]] ;;
|
||||||
|
browser) [[ $CFG_BROWSERS == yes ]] ;;
|
||||||
|
*) return 1 ;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
+553
@@ -0,0 +1,553 @@
|
|||||||
|
# shellcheck shell=bash
|
||||||
|
#
|
||||||
|
# The interactive front end.
|
||||||
|
#
|
||||||
|
# This is the whole configuration interface. There is a file behind it, but no
|
||||||
|
# part of the program ever asks anyone to open it: one switch on the front
|
||||||
|
# screen, a settings list for the categories, and a list of the applications
|
||||||
|
# themselves for the cases where the automatic answer is not the wanted one.
|
||||||
|
|
||||||
|
# Terminal mode.
|
||||||
|
#
|
||||||
|
# bash flips the terminal into non-canonical mode for each `read -sn1` and back
|
||||||
|
# out again in between. That gap matters: in canonical mode DEL is the ERASE
|
||||||
|
# character, so the line discipline eats it instead of delivering it, and a
|
||||||
|
# backspace typed while the interface was between reads simply vanishes.
|
||||||
|
# Holding non-canonical mode for the whole interface removes the gap.
|
||||||
|
MCA_TERM_SAVED=''
|
||||||
|
|
||||||
|
mca_ui_term_raw() {
|
||||||
|
mca_have stty || return 0
|
||||||
|
[[ -t 0 ]] || return 0
|
||||||
|
[[ -n $MCA_TERM_SAVED ]] && return 0
|
||||||
|
|
||||||
|
MCA_TERM_SAVED="$(stty -g 2>/dev/null)" || { MCA_TERM_SAVED=''; return 0; }
|
||||||
|
stty -icanon -echo min 1 time 0 2>/dev/null || true
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_ui_term_restore() {
|
||||||
|
[[ -n $MCA_TERM_SAVED ]] || return 0
|
||||||
|
stty "$MCA_TERM_SAVED" 2>/dev/null || true
|
||||||
|
MCA_TERM_SAVED=''
|
||||||
|
}
|
||||||
|
|
||||||
|
# Runs an action with the terminal handed back to normal line mode, so anything
|
||||||
|
# it prints - or prompts for - behaves the way a program expects.
|
||||||
|
mca_ui_cooked() {
|
||||||
|
mca_ui_term_restore
|
||||||
|
"$@"
|
||||||
|
local rc=$?
|
||||||
|
mca_ui_term_raw
|
||||||
|
return $rc
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_read_key
|
||||||
|
# One keypress, resolved to a symbolic name. Arrow keys arrive as ESC [ A, so
|
||||||
|
# the tail of the sequence is consumed here rather than being mistaken for
|
||||||
|
# three separate presses.
|
||||||
|
mca_read_key() {
|
||||||
|
local k rest
|
||||||
|
|
||||||
|
IFS= read -rsn1 k || return 1
|
||||||
|
|
||||||
|
case "$k" in
|
||||||
|
$'\e')
|
||||||
|
if IFS= read -rsn2 -t 0.05 rest; then
|
||||||
|
case "$rest" in
|
||||||
|
'[A') printf 'up\n' ;;
|
||||||
|
'[B') printf 'down\n' ;;
|
||||||
|
'[C') printf 'right\n' ;;
|
||||||
|
'[D') printf 'left\n' ;;
|
||||||
|
*) printf 'escape\n' ;;
|
||||||
|
esac
|
||||||
|
else
|
||||||
|
printf 'escape\n'
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
''|$'\r') printf 'enter\n' ;;
|
||||||
|
$'\x7f'|$'\b') printf 'backspace\n' ;;
|
||||||
|
' ') printf 'space\n' ;;
|
||||||
|
*) printf '%s\n' "$k" ;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_ui_read_line <initial>
|
||||||
|
# A minimal line editor built on mca_read_key, with the result in
|
||||||
|
# MCA_LINE_RESULT. This exists instead of bash's own `read -r` because mixing
|
||||||
|
# line mode into a single-key interface breaks it: after one cooked-mode read
|
||||||
|
# the following `read -sn1` stops receiving keystrokes entirely.
|
||||||
|
MCA_LINE_RESULT=''
|
||||||
|
|
||||||
|
mca_ui_read_line() {
|
||||||
|
local buf="${1:-}" key
|
||||||
|
|
||||||
|
MCA_LINE_RESULT=''
|
||||||
|
printf '%s' "$buf"
|
||||||
|
|
||||||
|
while true; do
|
||||||
|
key="$(mca_read_key)" || { printf '\n'; return 1; }
|
||||||
|
|
||||||
|
case "$key" in
|
||||||
|
enter)
|
||||||
|
printf '\n'
|
||||||
|
MCA_LINE_RESULT="$buf"
|
||||||
|
return 0
|
||||||
|
;;
|
||||||
|
escape)
|
||||||
|
printf '\n'
|
||||||
|
return 1
|
||||||
|
;;
|
||||||
|
backspace)
|
||||||
|
if [[ -n $buf ]]; then
|
||||||
|
buf="${buf%?}"
|
||||||
|
printf '\b \b'
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
space)
|
||||||
|
buf+=' '
|
||||||
|
printf ' '
|
||||||
|
;;
|
||||||
|
up|down|left|right) ;;
|
||||||
|
*)
|
||||||
|
[[ ${#key} -eq 1 ]] || continue
|
||||||
|
buf+="$key"
|
||||||
|
printf '%s' "$key"
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_pause() {
|
||||||
|
printf '\n %s' "$(mca_msg "Press any key to continue...")"
|
||||||
|
read -rsn1 _ || true
|
||||||
|
printf '\n'
|
||||||
|
}
|
||||||
|
|
||||||
|
# _mca_row <label> <value>
|
||||||
|
# printf's %-28s pads by bytes, so a label containing "ü" comes out one column
|
||||||
|
# short. ${#s} counts characters in a UTF-8 locale, so the padding is computed
|
||||||
|
# here instead - and applied inline, because command substitution would eat the
|
||||||
|
# trailing spaces again.
|
||||||
|
_mca_row() {
|
||||||
|
local label="$1" value="$2" pad
|
||||||
|
pad=$(( 30 - ${#label} ))
|
||||||
|
(( pad < 0 )) && pad=0
|
||||||
|
printf ' %s%*s %s\n' "$label" "$pad" '' "$value"
|
||||||
|
}
|
||||||
|
|
||||||
|
_mca_onoff() {
|
||||||
|
if [[ $1 == yes ]]; then
|
||||||
|
printf '%s%s%s' "$MCA_C_GREEN" "$(mca_msg "ON")" "$MCA_C_RESET"
|
||||||
|
else
|
||||||
|
printf '%s%s%s' "$MCA_C_DIM" "$(mca_msg "OFF")" "$MCA_C_RESET"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Status
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# mca_ui_status
|
||||||
|
# Shared by the `status` subcommand and the menu header. Scans, so the numbers
|
||||||
|
# describe what is on disk right now rather than what was true at the last run.
|
||||||
|
mca_ui_status() {
|
||||||
|
local last covered
|
||||||
|
|
||||||
|
mca_scan_once
|
||||||
|
mca_count_routes
|
||||||
|
|
||||||
|
last="$(mca_state_read last_apply '')"
|
||||||
|
|
||||||
|
_mca_row "$(mca_msg "Autoscroll")" "$(_mca_onoff "$CFG_ENABLED")"
|
||||||
|
printf '\n'
|
||||||
|
|
||||||
|
if [[ $CFG_ENABLED == yes ]]; then
|
||||||
|
covered="$MCA_N_ON"
|
||||||
|
else
|
||||||
|
covered=0
|
||||||
|
fi
|
||||||
|
|
||||||
|
_mca_row "$(mca_msg "Applications covered")" \
|
||||||
|
"$(mca_msg "%d of %d" "$covered" "$(( MCA_N_ON + MCA_N_OFF + MCA_N_UNKNOWN ))")"
|
||||||
|
|
||||||
|
if (( MCA_N_UNKNOWN )); then
|
||||||
|
_mca_row "$(mca_msg "Not identified")" \
|
||||||
|
"${MCA_C_DIM}$(mca_msg "%d - see the applications list" "$MCA_N_UNKNOWN")${MCA_C_RESET}"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if mca_steam_installed; then
|
||||||
|
if mca_steam_patched; then
|
||||||
|
_mca_row "$(mca_msg "Steam")" "$(_mca_onoff yes)"
|
||||||
|
elif [[ $CFG_STEAM == yes && $CFG_ENABLED == yes ]] && mca_steam_waiting; then
|
||||||
|
_mca_row "$(mca_msg "Steam")" \
|
||||||
|
"${MCA_C_DIM}$(mca_msg "waiting until Steam is closed")${MCA_C_RESET}"
|
||||||
|
elif [[ $CFG_STEAM == yes && $CFG_ENABLED == yes ]]; then
|
||||||
|
_mca_row "$(mca_msg "Steam")" \
|
||||||
|
"${MCA_C_YELLOW}$(mca_msg "not patched yet")${MCA_C_RESET}"
|
||||||
|
else
|
||||||
|
_mca_row "$(mca_msg "Steam")" "$(_mca_onoff no)"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
if mca_watch_available; then
|
||||||
|
if mca_watch_enabled; then
|
||||||
|
_mca_row "$(mca_msg "New applications")" "$(_mca_onoff yes)"
|
||||||
|
else
|
||||||
|
_mca_row "$(mca_msg "New applications")" "$(_mca_onoff no)"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
_mca_row "$(mca_msg "Last applied")" "$(mca_time_ago "$last")"
|
||||||
|
|
||||||
|
if [[ $CFG_ENABLED == yes ]]; then
|
||||||
|
printf '\n %s%s%s\n' "$MCA_C_DIM" \
|
||||||
|
"$(mca_msg "Applications pick this up the next time they are started.")" \
|
||||||
|
"$MCA_C_RESET"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Settings
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Format: Key|type|default|label-msgid
|
||||||
|
# type is bool or text.
|
||||||
|
MCA_SETTINGS=(
|
||||||
|
"PatchApps|bool|yes|Electron and CEF applications"
|
||||||
|
"PatchBrowsers|bool|yes|Chromium-based browsers"
|
||||||
|
"PatchFlatpak|bool|yes|Flatpak applications"
|
||||||
|
"PatchSnap|bool|yes|Snap applications"
|
||||||
|
"PatchAutostart|bool|yes|Programs that start themselves at login"
|
||||||
|
"PatchSteam|bool|yes|Steam"
|
||||||
|
"PatchSpotify|bool|yes|Spotify"
|
||||||
|
"WatchNewApps|bool|yes|Apply to newly installed applications"
|
||||||
|
"ExtraFlags|text||Additional Chromium arguments"
|
||||||
|
)
|
||||||
|
|
||||||
|
_mca_is_true() {
|
||||||
|
case "${1,,}" in
|
||||||
|
yes|y|true|1|on|enabled) return 0 ;;
|
||||||
|
*) return 1 ;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
|
MCA_SETTING_SHOWN=''
|
||||||
|
MCA_LBL_ON=''
|
||||||
|
MCA_LBL_OFF=''
|
||||||
|
MCA_LBL_NONE=''
|
||||||
|
|
||||||
|
_mca_setting_display() {
|
||||||
|
local type="$1" value="$2"
|
||||||
|
|
||||||
|
case "$type" in
|
||||||
|
bool)
|
||||||
|
if _mca_is_true "$value"; then
|
||||||
|
MCA_SETTING_SHOWN="${MCA_C_GREEN}${MCA_LBL_ON}${MCA_C_RESET}"
|
||||||
|
else
|
||||||
|
MCA_SETTING_SHOWN="${MCA_C_DIM}${MCA_LBL_OFF}${MCA_C_RESET}"
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
text)
|
||||||
|
if [[ -n $value ]]; then
|
||||||
|
MCA_SETTING_SHOWN="$value"
|
||||||
|
else
|
||||||
|
MCA_SETTING_SHOWN="${MCA_C_DIM}${MCA_LBL_NONE}${MCA_C_RESET}"
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
*) MCA_SETTING_SHOWN="$value" ;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_ui_settings
|
||||||
|
# A cursor list rather than a numbered menu. The frame is assembled in memory
|
||||||
|
# and written once, and everything constant is resolved before the loop:
|
||||||
|
# drawing the naive way costs a command substitution per label per frame, which
|
||||||
|
# is slow enough that arrow keys feel like the console is reloading.
|
||||||
|
#
|
||||||
|
# Returns 0 when something was changed, so the caller knows to re-apply.
|
||||||
|
mca_ui_settings() {
|
||||||
|
local count=${#MCA_SETTINGS[@]}
|
||||||
|
local -a names=() types=() defaults=() labels=() values=()
|
||||||
|
local spec name type default label locale i key frame row pad dirty=1 cursor=0
|
||||||
|
local touched=0
|
||||||
|
|
||||||
|
locale="$(mca_ui_locale)"
|
||||||
|
mca_msg_into "$locale" "ON"; MCA_LBL_ON="$MCA_MSG_RESULT"
|
||||||
|
mca_msg_into "$locale" "OFF"; MCA_LBL_OFF="$MCA_MSG_RESULT"
|
||||||
|
mca_msg_into "$locale" "(none)"; MCA_LBL_NONE="$MCA_MSG_RESULT"
|
||||||
|
|
||||||
|
for spec in "${MCA_SETTINGS[@]}"; do
|
||||||
|
IFS='|' read -r name type default label <<< "$spec"
|
||||||
|
names+=("$name"); types+=("$type"); defaults+=("$default")
|
||||||
|
mca_msg_into "$locale" "$label"
|
||||||
|
labels+=("$MCA_MSG_RESULT")
|
||||||
|
done
|
||||||
|
|
||||||
|
local title hint
|
||||||
|
mca_msg_into "$locale" "Settings"; title="$MCA_MSG_RESULT"
|
||||||
|
mca_msg_into "$locale" "Up/Down select - Space or Right changes - q goes back"
|
||||||
|
hint="$MCA_MSG_RESULT"
|
||||||
|
|
||||||
|
local clearseq
|
||||||
|
clearseq="$(clear 2>/dev/null)" || clearseq=$'\033[H\033[2J'
|
||||||
|
|
||||||
|
while true; do
|
||||||
|
if (( dirty )); then
|
||||||
|
for i in "${!names[@]}"; do
|
||||||
|
_mca_config_lookup "${names[i]}" "${defaults[i]}"
|
||||||
|
values[i]="$MCA_CONFIG_VALUE"
|
||||||
|
done
|
||||||
|
dirty=0
|
||||||
|
fi
|
||||||
|
|
||||||
|
frame="$clearseq"$'\n'"${MCA_C_BOLD}${MCA_C_BLUE} ${title}${MCA_C_RESET}"$'\n\n'
|
||||||
|
|
||||||
|
local marker selected="${MCA_C_BLUE}▸${MCA_C_RESET} "
|
||||||
|
for i in "${!names[@]}"; do
|
||||||
|
_mca_setting_display "${types[i]}" "${values[i]}"
|
||||||
|
pad=$(( 46 - ${#labels[i]} ))
|
||||||
|
(( pad < 0 )) && pad=0
|
||||||
|
if (( i == cursor )); then marker="$selected"; else marker=' '; fi
|
||||||
|
printf -v row ' %s%s%*s %s' \
|
||||||
|
"$marker" "${labels[i]}" "$pad" '' "$MCA_SETTING_SHOWN"
|
||||||
|
frame+="$row"$'\n'
|
||||||
|
done
|
||||||
|
|
||||||
|
frame+=$'\n'" ${MCA_C_DIM}${hint}${MCA_C_RESET}"$'\n'
|
||||||
|
printf '%s' "$frame"
|
||||||
|
|
||||||
|
key="$(mca_read_key)" || return "$(( ! touched ))"
|
||||||
|
|
||||||
|
type="${types[cursor]}"
|
||||||
|
name="${names[cursor]}"
|
||||||
|
|
||||||
|
case "$key" in
|
||||||
|
up|k) cursor=$(( (cursor - 1 + count) % count )) ;;
|
||||||
|
down|j) cursor=$(( (cursor + 1) % count )) ;;
|
||||||
|
space|enter|right|l|left|h)
|
||||||
|
if [[ $type == text ]]; then
|
||||||
|
[[ $key == left || $key == h ]] && continue
|
||||||
|
mca_ui_edit_text "$name" "${values[cursor]}" && touched=1
|
||||||
|
else
|
||||||
|
if _mca_is_true "${values[cursor]}"; then
|
||||||
|
mca_config_set "$name" no
|
||||||
|
else
|
||||||
|
mca_config_set "$name" yes
|
||||||
|
fi || { mca_bad "$(mca_msg "Could not save the setting.")"; mca_pause; }
|
||||||
|
touched=1
|
||||||
|
fi
|
||||||
|
dirty=1
|
||||||
|
;;
|
||||||
|
q|Q|escape) return "$(( ! touched ))" ;;
|
||||||
|
*) ;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_ui_edit_text <key> <current>
|
||||||
|
mca_ui_edit_text() {
|
||||||
|
local name="$1" current="$2"
|
||||||
|
|
||||||
|
printf '\n %s\n' "$(mca_msg "Arguments separated by spaces, empty for none:")"
|
||||||
|
printf ' > '
|
||||||
|
|
||||||
|
if mca_ui_read_line "$current"; then
|
||||||
|
mca_config_set "$name" "$MCA_LINE_RESULT" \
|
||||||
|
|| { mca_bad "$(mca_msg "Could not save the setting.")"; mca_pause; }
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Applications
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# mca_ui_apps
|
||||||
|
# Every application that was found, what will happen to it, and a key to
|
||||||
|
# change that. This is where an AppImage that could not be identified gets
|
||||||
|
# turned on, and where a single application gets left out without having to
|
||||||
|
# switch off its whole category.
|
||||||
|
#
|
||||||
|
# Returns 0 when something was changed.
|
||||||
|
mca_ui_apps() {
|
||||||
|
local count key frame row pad i cursor=0 dirty=1 touched=0 locale
|
||||||
|
local -a labels=() states=()
|
||||||
|
|
||||||
|
locale="$(mca_ui_locale)"
|
||||||
|
|
||||||
|
local title hint legend warn
|
||||||
|
mca_msg_into "$locale" "Applications"; title="$MCA_MSG_RESULT"
|
||||||
|
mca_msg_into "$locale" "Up/Down select - Space turns one on or off - q goes back"
|
||||||
|
hint="$MCA_MSG_RESULT"
|
||||||
|
mca_msg_into "$locale" "Anything not identified is left alone until it is turned on here."
|
||||||
|
legend="$MCA_MSG_RESULT"
|
||||||
|
mca_msg_into "$locale" "Autoscroll is off - this is what would be covered."
|
||||||
|
warn="$MCA_MSG_RESULT"
|
||||||
|
|
||||||
|
# The per-row labels are resolved once, here. Looking them up inside the
|
||||||
|
# drawing loop is a fork per row per keypress, and that is enough to make
|
||||||
|
# the arrow keys feel like the screen is reloading.
|
||||||
|
local l_off l_cannot l_on l_steam l_flagfile l_launcher
|
||||||
|
mca_msg_into "$locale" "off"; l_off="$MCA_MSG_RESULT"
|
||||||
|
mca_msg_into "$locale" "cannot tell"; l_cannot="$MCA_MSG_RESULT"
|
||||||
|
mca_msg_into "$locale" "on"; l_on="$MCA_MSG_RESULT"
|
||||||
|
mca_msg_into "$locale" "Steam"; l_steam="$MCA_MSG_RESULT"
|
||||||
|
mca_msg_into "$locale" "flag file"; l_flagfile="$MCA_MSG_RESULT"
|
||||||
|
mca_msg_into "$locale" "launcher"; l_launcher="$MCA_MSG_RESULT"
|
||||||
|
|
||||||
|
local s_off="${MCA_C_DIM}${l_off}${MCA_C_RESET}"
|
||||||
|
local s_cannot="${MCA_C_DIM}${l_cannot}${MCA_C_RESET}"
|
||||||
|
local s_on="${MCA_C_GREEN}${l_on}${MCA_C_RESET}"
|
||||||
|
local s_steam="${s_on} ${MCA_C_DIM}(${l_steam})${MCA_C_RESET}"
|
||||||
|
local s_flags="${s_on} ${MCA_C_DIM}(${l_flagfile})${MCA_C_RESET}"
|
||||||
|
local s_desktop="${s_on} ${MCA_C_DIM}(${l_launcher})${MCA_C_RESET}"
|
||||||
|
|
||||||
|
local clearseq
|
||||||
|
clearseq="$(clear 2>/dev/null)" || clearseq=$'\033[H\033[2J'
|
||||||
|
|
||||||
|
printf '%s\n %s\n' "$clearseq" "$(mca_msg "Looking at the installed applications...")"
|
||||||
|
mca_config_load
|
||||||
|
mca_scan_once
|
||||||
|
count=${#MCA_IDS[@]}
|
||||||
|
|
||||||
|
if (( count == 0 )); then
|
||||||
|
printf '\n %s\n' "$(mca_msg "No Chromium-based applications found.")"
|
||||||
|
mca_pause
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
while true; do
|
||||||
|
if (( dirty )); then
|
||||||
|
mca_config_load
|
||||||
|
mca_count_routes
|
||||||
|
labels=(); states=()
|
||||||
|
for i in "${!MCA_IDS[@]}"; do
|
||||||
|
labels+=("${MCA_NAMES[i]}")
|
||||||
|
states+=("${MCA_ROUTES[i]}")
|
||||||
|
done
|
||||||
|
dirty=0
|
||||||
|
fi
|
||||||
|
|
||||||
|
frame="$clearseq"$'\n'"${MCA_C_BOLD}${MCA_C_BLUE} ${title}${MCA_C_RESET}"$'\n\n'
|
||||||
|
|
||||||
|
local marker selected="${MCA_C_BLUE}▸${MCA_C_RESET} " shown
|
||||||
|
for i in "${!labels[@]}"; do
|
||||||
|
case "${states[i]}" in
|
||||||
|
off) shown="$s_off" ;;
|
||||||
|
unknown) shown="$s_cannot" ;;
|
||||||
|
steam) shown="$s_steam" ;;
|
||||||
|
flags) shown="$s_flags" ;;
|
||||||
|
*) shown="$s_desktop" ;;
|
||||||
|
esac
|
||||||
|
pad=$(( 34 - ${#labels[i]} ))
|
||||||
|
(( pad < 0 )) && pad=0
|
||||||
|
if (( i == cursor )); then marker="$selected"; else marker=' '; fi
|
||||||
|
printf -v row ' %s%s%*s %s' "$marker" "${labels[i]}" "$pad" '' "$shown"
|
||||||
|
frame+="$row"$'\n'
|
||||||
|
done
|
||||||
|
|
||||||
|
frame+=$'\n'
|
||||||
|
# Without this the list reads as a list of what is switched on, which
|
||||||
|
# it is not while the whole thing is off.
|
||||||
|
if [[ $CFG_ENABLED != yes ]]; then
|
||||||
|
frame+=" ${MCA_C_YELLOW}${warn}${MCA_C_RESET}"$'\n'
|
||||||
|
fi
|
||||||
|
frame+=" ${MCA_C_DIM}${legend}${MCA_C_RESET}"$'\n'
|
||||||
|
frame+=" ${MCA_C_DIM}${hint}${MCA_C_RESET}"$'\n'
|
||||||
|
printf '%s' "$frame"
|
||||||
|
|
||||||
|
key="$(mca_read_key)" || return "$(( ! touched ))"
|
||||||
|
|
||||||
|
case "$key" in
|
||||||
|
up|k) cursor=$(( (cursor - 1 + count) % count )) ;;
|
||||||
|
down|j) cursor=$(( (cursor + 1) % count )) ;;
|
||||||
|
space|enter|right|left|l|h)
|
||||||
|
case "${states[cursor]}" in
|
||||||
|
off|unknown)
|
||||||
|
mca_config_list_del Skip "${MCA_IDS[cursor]}"
|
||||||
|
mca_config_list_add Include "${MCA_IDS[cursor]}"
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
mca_config_list_del Include "${MCA_IDS[cursor]}"
|
||||||
|
mca_config_list_add Skip "${MCA_IDS[cursor]}"
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
touched=1
|
||||||
|
dirty=1
|
||||||
|
;;
|
||||||
|
q|Q|escape) return "$(( ! touched ))" ;;
|
||||||
|
*) ;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# The menu
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
mca_ui_menu() {
|
||||||
|
local choice
|
||||||
|
|
||||||
|
mca_ui_term_raw
|
||||||
|
trap 'mca_ui_term_restore' EXIT INT TERM
|
||||||
|
|
||||||
|
while true; do
|
||||||
|
mca_config_load
|
||||||
|
|
||||||
|
clear 2>/dev/null || true
|
||||||
|
mca_head " $MCA_PRETTY"
|
||||||
|
mca_ui_status
|
||||||
|
printf '\n'
|
||||||
|
printf ' [1] %s\n' "$(mca_msg "Turn autoscroll on or off")"
|
||||||
|
printf ' [2] %s\n' "$(mca_msg "Re-apply everything")"
|
||||||
|
printf ' [3] %s\n' "$(mca_msg "Applications")"
|
||||||
|
printf ' [4] %s\n' "$(mca_msg "Settings")"
|
||||||
|
printf ' [q] %s\n' "$(mca_msg "Quit")"
|
||||||
|
printf '\n > '
|
||||||
|
|
||||||
|
choice="$(mca_read_key)" || {
|
||||||
|
printf '\n'; mca_ui_term_restore; trap - EXIT INT TERM; return 0
|
||||||
|
}
|
||||||
|
case "$choice" in
|
||||||
|
enter|space|up|down|left|right|escape) choice='' ;;
|
||||||
|
esac
|
||||||
|
printf '%s\n' "$choice"
|
||||||
|
|
||||||
|
case "$choice" in
|
||||||
|
1)
|
||||||
|
MCA_UI_NEEDS_ACK=''
|
||||||
|
if [[ $CFG_ENABLED == yes ]]; then
|
||||||
|
mca_ui_cooked mca_do_disable
|
||||||
|
else
|
||||||
|
mca_ui_cooked mca_do_enable
|
||||||
|
fi
|
||||||
|
[[ -n $MCA_UI_NEEDS_ACK ]] && mca_pause
|
||||||
|
;;
|
||||||
|
# Not a plain apply: with the watcher running there is never
|
||||||
|
# anything left for one to do, and a menu entry that answers
|
||||||
|
# "already done" every time is not an action. This is the repair -
|
||||||
|
# everything is taken back and written again from scratch, which is
|
||||||
|
# what fixes an application that drifted, a flag file somebody
|
||||||
|
# edited, or Steam after it restored its own script.
|
||||||
|
2)
|
||||||
|
mca_ui_cooked mca_do_apply --rebuild
|
||||||
|
mca_pause
|
||||||
|
;;
|
||||||
|
3)
|
||||||
|
if mca_ui_apps; then
|
||||||
|
[[ $CFG_ENABLED == yes ]] && mca_ui_cooked mca_do_apply --rebuild
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
4)
|
||||||
|
if mca_ui_settings; then
|
||||||
|
[[ $CFG_ENABLED == yes ]] && mca_ui_cooked mca_do_apply --rebuild
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
q|Q) mca_ui_term_restore; trap - EXIT INT TERM; return 0 ;;
|
||||||
|
# Anything else - Enter, arrow keys, stray characters - just
|
||||||
|
# redraws. Escape is deliberately not a quit key, so a mistyped
|
||||||
|
# arrow key cannot close the menu.
|
||||||
|
*) ;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
}
|
||||||
@@ -0,0 +1,654 @@
|
|||||||
|
# shellcheck shell=bash
|
||||||
|
#
|
||||||
|
# Putting the flag where the application will read it, and taking it back out.
|
||||||
|
#
|
||||||
|
# There are two ways in, and the order matters:
|
||||||
|
#
|
||||||
|
# 1. A flag file. Where the distribution wraps Electron and Chromium in a
|
||||||
|
# launcher script that reads extra arguments from
|
||||||
|
# $XDG_CONFIG_HOME/<name>-flags.conf - Arch and its derivatives do, and it
|
||||||
|
# is the convention their packages follow - this is the good one: it is
|
||||||
|
# the supported way to pass arguments, it survives package upgrades
|
||||||
|
# untouched, and it applies however the program is started, including from
|
||||||
|
# a terminal.
|
||||||
|
#
|
||||||
|
# Nothing is assumed about which distribution this is. The launcher itself
|
||||||
|
# is read, and the route is taken only for a launcher that really does
|
||||||
|
# name such a file. Elsewhere - Debian, Ubuntu, Fedora, openSUSE, where
|
||||||
|
# the equivalent file lives under /etc and is the system's to write -
|
||||||
|
# there is no flag file to use and route 2 answers for everything.
|
||||||
|
#
|
||||||
|
# 2. A desktop entry. For applications that ship their own binary with no
|
||||||
|
# wrapper, and for everything a Flatpak or a snap contains, there is
|
||||||
|
# nowhere else to put an argument, so a copy of the entry with the flag
|
||||||
|
# appended goes into ~/.local/share/applications, where it shadows the
|
||||||
|
# system one.
|
||||||
|
#
|
||||||
|
# Nothing outside $HOME is ever written to.
|
||||||
|
|
||||||
|
MCA_MARK_BEGIN='# >>> middleclick-autoscroll'
|
||||||
|
MCA_MARK_END='# <<< middleclick-autoscroll'
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Feature lists
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Both --enable-features and --enable-blink-features take a comma separated
|
||||||
|
# list, and Chromium keeps the last one it is given and drops the rest. A
|
||||||
|
# second one of the same kind would therefore silently switch off whatever the
|
||||||
|
# first one turned on, so an option that is already there is extended instead.
|
||||||
|
|
||||||
|
# _mca_list_merge <list> <wanted>
|
||||||
|
# The two lists as one, in the order they came and without repeating anything.
|
||||||
|
_mca_list_merge() {
|
||||||
|
local out="$1" item
|
||||||
|
for item in ${2//,/ }; do
|
||||||
|
[[ ",$out," == *",$item,"* ]] && continue
|
||||||
|
out="${out:+$out,}$item"
|
||||||
|
done
|
||||||
|
printf '%s' "$out"
|
||||||
|
}
|
||||||
|
|
||||||
|
# _mca_list_strip <list> <unwanted>
|
||||||
|
# The list without any of the named entries.
|
||||||
|
_mca_list_strip() {
|
||||||
|
local out='' item
|
||||||
|
for item in ${1//,/ }; do
|
||||||
|
[[ ",$2," == *",$item,"* ]] && continue
|
||||||
|
out="${out:+$out,}$item"
|
||||||
|
done
|
||||||
|
printf '%s' "$out"
|
||||||
|
}
|
||||||
|
|
||||||
|
# The two options, as a regular expression branch, for the places that have to
|
||||||
|
# recognise either of them.
|
||||||
|
MCA_FEATURE_OPTS='--enable-blink-features|--enable-features'
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Command lines
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# _mca_exec_insert_at <exec line>
|
||||||
|
# Where an argument has to go: after the program and its own arguments, but
|
||||||
|
# before the first field code (%U and friends) or Flatpak's @@ markers, which
|
||||||
|
# are placeholders the launcher expands rather than arguments.
|
||||||
|
_mca_exec_insert_at() {
|
||||||
|
local rest="$1" tok idx=0
|
||||||
|
|
||||||
|
while [[ -n $rest ]]; do
|
||||||
|
while [[ $rest == ' '* ]]; do rest="${rest# }"; idx=$(( idx + 1 )); done
|
||||||
|
[[ -n $rest ]] || break
|
||||||
|
tok="${rest%% *}"
|
||||||
|
case "$tok" in
|
||||||
|
%[a-zA-Z]|@@|@@u) printf '%s\n' "$idx"; return 0 ;;
|
||||||
|
esac
|
||||||
|
rest="${rest:${#tok}}"
|
||||||
|
idx=$(( idx + ${#tok} ))
|
||||||
|
done
|
||||||
|
|
||||||
|
printf '%s\n' "$(( ${#1} ))"
|
||||||
|
}
|
||||||
|
|
||||||
|
# _mca_exec_after_program <exec line>
|
||||||
|
# The position just after the program name, for arguments that a program only
|
||||||
|
# accepts before its positional ones.
|
||||||
|
_mca_exec_after_program() {
|
||||||
|
local rest="$1" idx=0 tok
|
||||||
|
|
||||||
|
while [[ $rest == ' '* ]]; do rest="${rest# }"; idx=$(( idx + 1 )); done
|
||||||
|
tok="${rest%% *}"
|
||||||
|
printf '%s\n' "$(( idx + ${#tok} ))"
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_exec_inject <exec line> [flags] [position: before-fields|after-program]
|
||||||
|
# The same line with the given flags added, defaulting to the configured ones.
|
||||||
|
# Prints nothing and returns 1 when there was nothing to change, so callers can
|
||||||
|
# tell a real edit from a no-op without diffing.
|
||||||
|
#
|
||||||
|
# A feature list that is already on the line is extended rather than repeated.
|
||||||
|
# See _mca_list_merge.
|
||||||
|
mca_exec_inject() {
|
||||||
|
local line="$1" flagstr="${2:-}" where="${3:-before-fields}"
|
||||||
|
local flag opt value existing merged re at changed=0
|
||||||
|
local -a flags
|
||||||
|
|
||||||
|
[[ -n $flagstr ]] || flagstr="$(mca_flags)"
|
||||||
|
read -r -a flags <<< "$flagstr"
|
||||||
|
|
||||||
|
for flag in "${flags[@]}"; do
|
||||||
|
case "$flag" in
|
||||||
|
--enable-blink-features=*|--enable-features=*)
|
||||||
|
opt="${flag%%=*}"
|
||||||
|
value="${flag#*=}"
|
||||||
|
re="(^|[[:space:]])$opt=([^[:space:]]*)"
|
||||||
|
if [[ $line =~ $re ]]; then
|
||||||
|
existing="${BASH_REMATCH[2]}"
|
||||||
|
merged="$(_mca_list_merge "$existing" "$value")"
|
||||||
|
[[ $merged == "$existing" ]] && continue
|
||||||
|
line="${line/$opt=$existing/$opt=$merged}"
|
||||||
|
changed=1
|
||||||
|
continue
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
[[ " $line " == *" $flag "* ]] && continue
|
||||||
|
|
||||||
|
if [[ $where == after-program ]]; then
|
||||||
|
at="$(_mca_exec_after_program "$line")"
|
||||||
|
line="${line:0:$at} $flag${line:$at}"
|
||||||
|
else
|
||||||
|
at="$(_mca_exec_insert_at "$line")"
|
||||||
|
if (( at >= ${#line} )); then
|
||||||
|
line="${line% } $flag"
|
||||||
|
else
|
||||||
|
line="${line:0:$at}$flag ${line:$at}"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
changed=1
|
||||||
|
done
|
||||||
|
|
||||||
|
(( changed )) || return 1
|
||||||
|
printf '%s\n' "$line"
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Flag files
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# mca_flags_apply <program> [kind]
|
||||||
|
# Writes the flags into the file the program's launcher reads. Returns 0 when
|
||||||
|
# the program has such a file (whether or not anything needed changing), 1 when
|
||||||
|
# it has none and the desktop entry route has to be used instead.
|
||||||
|
mca_flags_apply() {
|
||||||
|
local prog="$1" kind="${2:-app}" name target='' existing_target=''
|
||||||
|
local -a candidates=()
|
||||||
|
|
||||||
|
mapfile -t candidates < <(mca_flags_candidates "$prog" | awk '!seen[$0]++')
|
||||||
|
(( ${#candidates[@]} )) || return 1
|
||||||
|
|
||||||
|
# A wrapper that offers several files reads the first one that exists and
|
||||||
|
# ignores the rest, so an existing file is always the right one to edit.
|
||||||
|
for name in "${candidates[@]}"; do
|
||||||
|
if [[ -f "$MCA_XDG_CONFIG/$name" ]]; then
|
||||||
|
existing_target="$name"
|
||||||
|
_mca_flags_write "$MCA_XDG_CONFIG/$name" "$kind"
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
[[ -n $existing_target ]] && return 0
|
||||||
|
|
||||||
|
# None exists yet. The last candidate is the wrapper's own fallback - the
|
||||||
|
# generic electron-flags.conf rather than electron43-flags.conf - so
|
||||||
|
# creating that one also covers every other application using the same
|
||||||
|
# shared Electron.
|
||||||
|
target="${candidates[-1]}"
|
||||||
|
_mca_flags_write "$MCA_XDG_CONFIG/$target" "$kind"
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# _mca_flags_write <file> [kind]
|
||||||
|
# Adds the flags as a marked block, or merges into a feature list that is
|
||||||
|
# already in the file.
|
||||||
|
_mca_flags_write() {
|
||||||
|
local file="$1" kind="${2:-app}"
|
||||||
|
local content='' line flag opt want existing merged=0 block=''
|
||||||
|
local -a flags
|
||||||
|
local -A merged_opts=()
|
||||||
|
local created=0
|
||||||
|
|
||||||
|
read -r -a flags <<< "$(mca_flags "$kind")"
|
||||||
|
|
||||||
|
[[ -f $file ]] || created=1
|
||||||
|
if (( ! created )); then
|
||||||
|
content="$(< "$file")"
|
||||||
|
# Already ours: the block is rewritten below, so drop the old one first.
|
||||||
|
if [[ $content == *"$MCA_MARK_BEGIN"* ]]; then
|
||||||
|
content="$(_mca_flags_drop_block "$file")"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Merge into a feature list the user (or a distribution) put there, rather
|
||||||
|
# than write a second line of the same option further down.
|
||||||
|
if [[ $content == *--enable-* ]]; then
|
||||||
|
local out=''
|
||||||
|
while IFS= read -r line; do
|
||||||
|
if [[ $line =~ ^[[:space:]]*($MCA_FEATURE_OPTS)=([^[:space:]]*)[[:space:]]*$ ]]; then
|
||||||
|
opt="${BASH_REMATCH[1]}"
|
||||||
|
existing="${BASH_REMATCH[2]}"
|
||||||
|
want=''
|
||||||
|
for flag in "${flags[@]}"; do
|
||||||
|
[[ $flag == "$opt="* ]] && want="${flag#*=}"
|
||||||
|
done
|
||||||
|
if [[ -n $want ]]; then
|
||||||
|
line="$opt=$(_mca_list_merge "$existing" "$want")"
|
||||||
|
merged_opts["$opt"]=1
|
||||||
|
merged=1
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
out+="$line"$'\n'
|
||||||
|
done <<< "$content"
|
||||||
|
content="${out%$'\n'}"
|
||||||
|
fi
|
||||||
|
|
||||||
|
for flag in "${flags[@]}"; do
|
||||||
|
[[ -n ${merged_opts["${flag%%=*}"]:-} ]] && continue
|
||||||
|
block+="$flag"$'\n'
|
||||||
|
done
|
||||||
|
|
||||||
|
if [[ -n $block ]]; then
|
||||||
|
content="${content:+$content$'\n'}$MCA_MARK_BEGIN"$'\n'"$block$MCA_MARK_END"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if mca_write_if_changed "$file" "$content"$'\n'; then
|
||||||
|
MCA_CHANGES=$(( MCA_CHANGES + 1 ))
|
||||||
|
fi
|
||||||
|
|
||||||
|
if (( created )); then
|
||||||
|
mca_ledger_add flags "$file" created
|
||||||
|
elif (( merged )) && [[ -z $block ]]; then
|
||||||
|
mca_ledger_add flags "$file" merged
|
||||||
|
elif (( merged )); then
|
||||||
|
mca_ledger_add flags "$file" merged+block
|
||||||
|
else
|
||||||
|
mca_ledger_add flags "$file" block
|
||||||
|
fi
|
||||||
|
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
_mca_flags_drop_block() {
|
||||||
|
awk -v b="$MCA_MARK_BEGIN" -v e="$MCA_MARK_END" '
|
||||||
|
$0 == b { skip = 1; next }
|
||||||
|
$0 == e { skip = 0; next }
|
||||||
|
!skip
|
||||||
|
' "$1" 2>/dev/null
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_flags_revert <file> <detail>
|
||||||
|
mca_flags_revert() {
|
||||||
|
local file="$1" detail="$2" content line out='' opt existing new
|
||||||
|
|
||||||
|
[[ -f $file ]] || return 0
|
||||||
|
|
||||||
|
case "$detail" in
|
||||||
|
created)
|
||||||
|
# Only remove the file if nothing but our block ended up in it;
|
||||||
|
# anything else means the user started using it in the meantime.
|
||||||
|
content="$(_mca_flags_drop_block "$file")"
|
||||||
|
if [[ -z ${content//[[:space:]]/} ]]; then
|
||||||
|
rm -f -- "$file"
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
content="$(_mca_flags_drop_block "$file")"
|
||||||
|
|
||||||
|
if [[ $detail == merged* ]]; then
|
||||||
|
while IFS= read -r line; do
|
||||||
|
if [[ $line =~ ^[[:space:]]*($MCA_FEATURE_OPTS)=([^[:space:]]*)[[:space:]]*$ ]]; then
|
||||||
|
opt="${BASH_REMATCH[1]}"
|
||||||
|
existing="${BASH_REMATCH[2]}"
|
||||||
|
# Either name, whichever version of this program put it there.
|
||||||
|
new="$(_mca_list_strip "$existing" "$MCA_BROWSER_FEATURES")"
|
||||||
|
[[ -z $new ]] && continue
|
||||||
|
line="$opt=$new"
|
||||||
|
fi
|
||||||
|
out+="$line"$'\n'
|
||||||
|
done <<< "$content"
|
||||||
|
content="${out%$'\n'}"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [[ -z ${content//[[:space:]]/} ]]; then
|
||||||
|
rm -f -- "$file"
|
||||||
|
else
|
||||||
|
printf '%s\n' "$content" > "$file"
|
||||||
|
fi
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Desktop entries
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# A generated entry and an entry that was edited in place look similar and must
|
||||||
|
# never be confused: the first one is ours to delete, the second one is the
|
||||||
|
# user's file with one line changed and has to be restored from its backup. They
|
||||||
|
# carry different markers so that the scan, the "already done" checks and the
|
||||||
|
# undo can all tell them apart.
|
||||||
|
MCA_MARK_SHADOW='X-MCA-Generated'
|
||||||
|
MCA_MARK_INPLACE='X-MCA-Patched'
|
||||||
|
|
||||||
|
# _mca_desktop_transform <file> <marker> [flags] [position]
|
||||||
|
# The whole file with every Exec line rewritten - the main one and the one in
|
||||||
|
# each Desktop Action, because those are the right-click menu entries and a
|
||||||
|
# user who starts Steam from "Library" expects the same behaviour there.
|
||||||
|
_mca_desktop_transform() {
|
||||||
|
local file="$1" marker="$2" flags="${3:-}" where="${4:-before-fields}"
|
||||||
|
local line rest new marked=0
|
||||||
|
|
||||||
|
while IFS= read -r line || [[ -n $line ]]; do
|
||||||
|
case "$line" in
|
||||||
|
Exec=*)
|
||||||
|
rest="${line#Exec=}"
|
||||||
|
new="$(mca_exec_inject "$rest" "$flags" "$where")" && line="Exec=$new"
|
||||||
|
;;
|
||||||
|
# A D-Bus activated entry is started through its service file and
|
||||||
|
# the Exec line is never used, so the flag would go nowhere.
|
||||||
|
DBusActivatable=true)
|
||||||
|
line='DBusActivatable=false'
|
||||||
|
;;
|
||||||
|
# A marker from an older version; the current one is written below.
|
||||||
|
X-MCA-*)
|
||||||
|
continue
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
printf '%s\n' "$line"
|
||||||
|
|
||||||
|
if (( ! marked )) && [[ $line =~ ^[[:space:]]*\[Desktop\ Entry\][[:space:]]*$ ]]; then
|
||||||
|
printf '%s=%s\n' "$marker" "$MCA_VERSION"
|
||||||
|
marked=1
|
||||||
|
fi
|
||||||
|
done < "$file"
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_desktop_apply <id> <source entry> [flags] [position]
|
||||||
|
# Puts a patched copy in ~/.local/share/applications, or patches the entry in
|
||||||
|
# place when it already lives there.
|
||||||
|
mca_desktop_apply() {
|
||||||
|
local id="$1" src="$2" flags="${3:-}" where="${4:-before-fields}"
|
||||||
|
local target="$MCA_APPDIR/$id.desktop" content backup
|
||||||
|
|
||||||
|
if [[ "$src" == "$target" ]]; then
|
||||||
|
# The user's own entry - an AppImage, a web app shortcut, something
|
||||||
|
# installed by hand. There is nowhere to shadow it from, so it is
|
||||||
|
# edited directly and the original is kept.
|
||||||
|
grep -q "^$MCA_MARK_INPLACE=" "$src" 2>/dev/null && return 0
|
||||||
|
|
||||||
|
content="$(_mca_desktop_transform "$src" "$MCA_MARK_INPLACE" "$flags" "$where")"
|
||||||
|
[[ -n $content ]] || return 1
|
||||||
|
[[ "$content" == "$(< "$src")" ]] && return 0
|
||||||
|
|
||||||
|
backup="$(mca_backup "$src")" || return 1
|
||||||
|
if mca_write_if_changed "$src" "$content"$'\n'; then
|
||||||
|
MCA_CHANGES=$(( MCA_CHANGES + 1 ))
|
||||||
|
fi
|
||||||
|
mca_ledger_add inplace "$src" "$backup"
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
content="$(_mca_desktop_transform "$src" "$MCA_MARK_SHADOW" "$flags" "$where")"
|
||||||
|
[[ -n $content ]] || return 1
|
||||||
|
|
||||||
|
mkdir -p "$MCA_APPDIR" 2>/dev/null || return 1
|
||||||
|
|
||||||
|
# Something is already shadowing this entry. Unless it is a shadow of ours,
|
||||||
|
# it is the user's own file - possibly one we edited in place earlier - and
|
||||||
|
# overwriting it here would lose it.
|
||||||
|
if [[ -e $target ]] && ! grep -q "^$MCA_MARK_SHADOW=" "$target" 2>/dev/null; then
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
if mca_write_if_changed "$target" "$content"$'\n'; then
|
||||||
|
MCA_CHANGES=$(( MCA_CHANGES + 1 ))
|
||||||
|
fi
|
||||||
|
mca_ledger_add shadow "$target" "$src"
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Entries outside the search path
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Two directories hold desktop entries that no part of the XDG search path
|
||||||
|
# looks at, so nothing the scan does can reach them:
|
||||||
|
#
|
||||||
|
# ~/.config/autostart, where applications that start themselves at login
|
||||||
|
# write their own entry, pointing straight at their binary. Those bypass the
|
||||||
|
# entry in the menu completely, which is why Discord launched at login used
|
||||||
|
# to behave differently from Discord launched from the menu.
|
||||||
|
#
|
||||||
|
# The desktop folder, where a shortcut somebody dragged out of the menu -
|
||||||
|
# or asked Steam for - lives and nowhere else.
|
||||||
|
#
|
||||||
|
# Steam is in both, even though it is not a Chromium process itself: its
|
||||||
|
# entries need -noverifyfiles exactly like the menu one. The autostart entry is
|
||||||
|
# the one most likely to exist, because Steam writes it as soon as "run at
|
||||||
|
# startup" is ticked; without it a Steam started at login restores the patched
|
||||||
|
# web helper script and the watcher patches it back, over and over. The desktop
|
||||||
|
# ones are the gap behind "autoscroll works, except sometimes": starting a game
|
||||||
|
# from the desktop is a Steam start like any other, and a Steam start without
|
||||||
|
# the switch costs the interface its autoscroll for the rest of the session.
|
||||||
|
#
|
||||||
|
# Neither can be shadowed from anywhere, so both are edited where they stand,
|
||||||
|
# with the original kept.
|
||||||
|
|
||||||
|
# _mca_entry_patch_inplace <file> <gate: autostart|apps>
|
||||||
|
# One desktop entry that lives outside the XDG search path, edited where it is
|
||||||
|
# because there is nowhere to shadow it from.
|
||||||
|
#
|
||||||
|
# Anything that starts Steam gets Steam's own switch; a Chromium application
|
||||||
|
# gets the flag. What decides whether a Chromium application here is in scope
|
||||||
|
# differs by where the entry came from, which is what the gate says: an
|
||||||
|
# autostart entry follows the autostart setting, a shortcut follows the same
|
||||||
|
# rules as the application it is a shortcut to.
|
||||||
|
_mca_entry_patch_inplace() {
|
||||||
|
local file="$1" gate="$2"
|
||||||
|
local id prog packaging=native content backup kind
|
||||||
|
|
||||||
|
grep -q "^$MCA_MARK_INPLACE=" "$file" 2>/dev/null && return 0
|
||||||
|
|
||||||
|
_mca_desktop_read "$file"
|
||||||
|
[[ -n $DE_EXEC ]] || return 0
|
||||||
|
[[ $DE_HIDDEN == true ]] && return 0
|
||||||
|
|
||||||
|
mca_exec_program "$DE_EXEC" || return 0
|
||||||
|
prog="$MCA_PROG"
|
||||||
|
|
||||||
|
# A Flatpak or a snap entry names the wrapper rather than the application.
|
||||||
|
# The scan resolves those into an id; outside the scan the same has to
|
||||||
|
# happen here, or every Flatpak looks like the flatpak program itself.
|
||||||
|
if [[ ${prog##*/} == flatpak ]]; then
|
||||||
|
mca_exec_flatpak_id "$DE_EXEC" || return 0
|
||||||
|
prog="flatpak:$MCA_PROG"
|
||||||
|
packaging=flatpak
|
||||||
|
elif mca_snap_name "$prog"; then
|
||||||
|
prog="snap:$MCA_PROG"
|
||||||
|
packaging=snap
|
||||||
|
fi
|
||||||
|
|
||||||
|
if mca_prog_is_steam "$prog"; then
|
||||||
|
[[ $CFG_STEAM == yes ]] || return 0
|
||||||
|
content="$(_mca_desktop_transform "$file" "$MCA_MARK_INPLACE" \
|
||||||
|
"$MCA_STEAM_LAUNCH_FLAG" "$(mca_steam_flag_position "$packaging")")"
|
||||||
|
else
|
||||||
|
case "$packaging" in
|
||||||
|
flatpak) mca_flatpak_is_chromium "${prog#flatpak:}" || return 0 ;;
|
||||||
|
snap) mca_snap_is_chromium "${prog#snap:}" || return 0 ;;
|
||||||
|
*) mca_is_chromium "$prog" || return 0 ;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
mca_desktop_is_browser && kind=browser || kind=app
|
||||||
|
|
||||||
|
if [[ $gate == autostart ]]; then
|
||||||
|
[[ $CFG_AUTOSTART == yes ]] || return 0
|
||||||
|
else
|
||||||
|
id="${file##*/}"; id="${id%.desktop}"
|
||||||
|
mca_kind_wanted "$kind" "$id" "$packaging" || return 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
content="$(_mca_desktop_transform "$file" "$MCA_MARK_INPLACE" \
|
||||||
|
"$(mca_flags "$kind")")"
|
||||||
|
fi
|
||||||
|
|
||||||
|
[[ -n $content ]] || return 0
|
||||||
|
[[ "$content" == "$(< "$file")" ]] && return 0
|
||||||
|
|
||||||
|
backup="$(mca_backup "$file")" || return 0
|
||||||
|
if mca_write_if_changed "$file" "$content"$'\n'; then
|
||||||
|
MCA_CHANGES=$(( MCA_CHANGES + 1 ))
|
||||||
|
fi
|
||||||
|
mca_ledger_add inplace "$file" "$backup"
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_autostart_apply() {
|
||||||
|
local dir="$MCA_XDG_CONFIG/autostart" file
|
||||||
|
|
||||||
|
[[ -d $dir ]] || return 0
|
||||||
|
|
||||||
|
for file in "$dir"/*.desktop; do
|
||||||
|
[[ -f $file ]] || continue
|
||||||
|
_mca_entry_patch_inplace "$file" autostart
|
||||||
|
done
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_shortcuts_apply() {
|
||||||
|
local dir file
|
||||||
|
dir="$(mca_desktop_folder)"
|
||||||
|
|
||||||
|
[[ -d $dir ]] || return 0
|
||||||
|
|
||||||
|
for file in "$dir"/*.desktop; do
|
||||||
|
[[ -f $file ]] || continue
|
||||||
|
_mca_entry_patch_inplace "$file" apps
|
||||||
|
done
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Spotify
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# The official client is CEF rather than Electron and, when installed through
|
||||||
|
# spotify-launcher, is started by a program that builds its own command line.
|
||||||
|
# That launcher has a configuration file with a slot for exactly this.
|
||||||
|
|
||||||
|
mca_spotify_apply() {
|
||||||
|
local file="$MCA_XDG_CONFIG/spotify-launcher.conf" content line out='' backup
|
||||||
|
local found_section=0 found_args=0
|
||||||
|
|
||||||
|
mca_have spotify-launcher || return 0
|
||||||
|
|
||||||
|
if [[ -f $file ]]; then
|
||||||
|
content="$(< "$file")"
|
||||||
|
while IFS= read -r line; do
|
||||||
|
if [[ $line =~ ^[[:space:]]*\[spotify\][[:space:]]*$ ]]; then
|
||||||
|
found_section=1
|
||||||
|
elif [[ $line =~ ^[[:space:]]*extra_arguments[[:space:]]*=[[:space:]]*\[(.*)\][[:space:]]*$ ]]; then
|
||||||
|
local args="${BASH_REMATCH[1]}"
|
||||||
|
found_args=1
|
||||||
|
if [[ $args != *"$MCA_FEATURE"* ]]; then
|
||||||
|
line="extra_arguments = [${args:+$args, }\"$MCA_FLAG\"]"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
out+="$line"$'\n'
|
||||||
|
done <<< "$content"
|
||||||
|
content="${out%$'\n'}"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if (( ! found_args )); then
|
||||||
|
(( found_section )) || content="${content:+$content$'\n'}[spotify]"
|
||||||
|
content="${content:+$content$'\n'}extra_arguments = [\"$MCA_FLAG\"]"
|
||||||
|
fi
|
||||||
|
|
||||||
|
[[ -f $file ]] && backup="$(mca_backup "$file")"
|
||||||
|
|
||||||
|
if mca_write_if_changed "$file" "$content"$'\n'; then
|
||||||
|
MCA_CHANGES=$(( MCA_CHANGES + 1 ))
|
||||||
|
fi
|
||||||
|
mca_ledger_add inplace "$file" "${backup:-}"
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Leftovers
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# mca_prune_orphans
|
||||||
|
# Forgets changes there is no longer anything to undo.
|
||||||
|
#
|
||||||
|
# Uninstalling something deletes its entry from /usr/share/applications, but the
|
||||||
|
# copy shadowing it is in the user's home and pacman knows nothing about it. It
|
||||||
|
# would sit in the menu forever, offering to start a program that is no longer
|
||||||
|
# installed - and the watcher would not notice, because a plain apply only ever
|
||||||
|
# looks at what is there now. A file that was edited where it stood and has
|
||||||
|
# since been deleted is the same problem from the other side: its record would
|
||||||
|
# have `disable` put the file back.
|
||||||
|
mca_prune_orphans() {
|
||||||
|
local kind path source line
|
||||||
|
local -a lines=()
|
||||||
|
|
||||||
|
[[ -f $MCA_LEDGER ]] || return 0
|
||||||
|
mapfile -t lines < "$MCA_LEDGER"
|
||||||
|
|
||||||
|
for line in "${lines[@]}"; do
|
||||||
|
IFS=$'\t' read -r kind path source <<< "$line"
|
||||||
|
|
||||||
|
# An entry that was edited where it stood and has since been deleted -
|
||||||
|
# a game shortcut dragged to the wastebasket, an autostart entry the
|
||||||
|
# application removed. There is nothing left to put back, and keeping
|
||||||
|
# the record would have `disable` recreate a file the user threw away.
|
||||||
|
if [[ $kind == inplace && ! -e $path ]]; then
|
||||||
|
[[ -n $source ]] && rm -f -- "$MCA_BACKUPDIR/$source"
|
||||||
|
mca_ledger_forget "$path"
|
||||||
|
continue
|
||||||
|
fi
|
||||||
|
|
||||||
|
[[ $kind == shadow && -n $source ]] || continue
|
||||||
|
[[ -e $source ]] && continue
|
||||||
|
|
||||||
|
# Only ever remove something still recognisably ours.
|
||||||
|
if [[ -f $path ]] && grep -q "^$MCA_MARK_SHADOW=" "$path" 2>/dev/null; then
|
||||||
|
rm -f -- "$path"
|
||||||
|
MCA_CHANGES=$(( MCA_CHANGES + 1 ))
|
||||||
|
fi
|
||||||
|
mca_ledger_forget "$path"
|
||||||
|
done
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Undo
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
mca_revert_all() {
|
||||||
|
local kind path detail
|
||||||
|
|
||||||
|
[[ -f $MCA_LEDGER ]] || return 0
|
||||||
|
|
||||||
|
# Backwards, so a file that was recorded twice ends up at its oldest state.
|
||||||
|
while IFS=$'\t' read -r kind path detail; do
|
||||||
|
[[ -n $path ]] || continue
|
||||||
|
case "$kind" in
|
||||||
|
shadow)
|
||||||
|
# Only remove what is still recognisably ours.
|
||||||
|
if [[ -f $path ]] && grep -q "^$MCA_MARK_SHADOW=" "$path" 2>/dev/null; then
|
||||||
|
rm -f -- "$path"
|
||||||
|
MCA_CHANGES=$(( MCA_CHANGES + 1 ))
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
inplace)
|
||||||
|
if [[ -n $detail && -f "$MCA_BACKUPDIR/$detail" ]]; then
|
||||||
|
if [[ -e $path ]] || [[ -d "$(dirname -- "$path")" ]]; then
|
||||||
|
cp -p -- "$MCA_BACKUPDIR/$detail" "$path" 2>/dev/null \
|
||||||
|
&& MCA_CHANGES=$(( MCA_CHANGES + 1 ))
|
||||||
|
fi
|
||||||
|
rm -f -- "$MCA_BACKUPDIR/$detail"
|
||||||
|
elif [[ -f $path ]]; then
|
||||||
|
# No backup: the file did not exist before we wrote it.
|
||||||
|
rm -f -- "$path"
|
||||||
|
MCA_CHANGES=$(( MCA_CHANGES + 1 ))
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
flags)
|
||||||
|
mca_flags_revert "$path" "$detail" \
|
||||||
|
&& MCA_CHANGES=$(( MCA_CHANGES + 1 ))
|
||||||
|
;;
|
||||||
|
steam)
|
||||||
|
mca_steam_revert "$path" "$detail" \
|
||||||
|
&& MCA_CHANGES=$(( MCA_CHANGES + 1 ))
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
done < <(tac "$MCA_LEDGER" 2>/dev/null)
|
||||||
|
|
||||||
|
rm -f -- "$MCA_LEDGER"
|
||||||
|
rmdir "$MCA_BACKUPDIR" 2>/dev/null || true
|
||||||
|
return 0
|
||||||
|
}
|
||||||
@@ -0,0 +1,361 @@
|
|||||||
|
# shellcheck shell=bash
|
||||||
|
#
|
||||||
|
# Steam.
|
||||||
|
#
|
||||||
|
# Steam's interface is CEF, so the feature is there - but Steam builds the
|
||||||
|
# command line for its web helper itself and offers no way to add to it. The
|
||||||
|
# only place to get an argument in is the shell script that starts the helper,
|
||||||
|
# which lives inside Steam's own installation:
|
||||||
|
#
|
||||||
|
# ~/.local/share/Steam/ubuntu12_64/steamwebhelper_sniper_wrap.sh
|
||||||
|
#
|
||||||
|
# Steam compares the installed files against its manifest at every start - by
|
||||||
|
# size and timestamp rather than by content - and restores whatever differs.
|
||||||
|
# So the patch is written to look untouched: the bytes the flag costs are taken
|
||||||
|
# back out of the script's comments and the timestamp is put back afterwards,
|
||||||
|
# which leaves a file that is byte-for-byte the size Steam recorded and as old
|
||||||
|
# as Steam left it. A client that verifies its files finds nothing to repair
|
||||||
|
# and the flag survives however Steam was started - from the menu, from a game
|
||||||
|
# shortcut, from a launcher like Heroic, from a terminal.
|
||||||
|
#
|
||||||
|
# That is the part that has to work, because there is no way to make every
|
||||||
|
# possible way of starting Steam carry an argument. -noverifyfiles on the
|
||||||
|
# launcher entries is the second line rather than the first: it covers the case
|
||||||
|
# where the script has no comments left to pay for the flag and the patch has
|
||||||
|
# to grow the file. The trade-off is real and belongs to the user, so it is a
|
||||||
|
# switch of its own rather than part of the general application handling: with
|
||||||
|
# verification off, Steam no longer repairs a damaged installation by itself.
|
||||||
|
#
|
||||||
|
# A patch that does change the size still has to stay out of the way of a
|
||||||
|
# client that is already running, or the two programs spend the session undoing
|
||||||
|
# each other: Steam restores the script, the watcher patches it again, Steam
|
||||||
|
# restores it again, and the client never gets past its update dialog. A patch
|
||||||
|
# that keeps the size is invisible to that check and goes in either way.
|
||||||
|
#
|
||||||
|
# The file comes back on every client update, and the watcher re-applies the
|
||||||
|
# patch when that happens.
|
||||||
|
|
||||||
|
MCA_STEAM_LAUNCH_FLAG='-noverifyfiles'
|
||||||
|
|
||||||
|
# Every place a Steam installation is known to live, resolved and de-duplicated
|
||||||
|
# because ~/.steam/steam is normally a symlink into ~/.local/share.
|
||||||
|
#
|
||||||
|
# Which of these is the real one depends on how Steam was installed: Valve's
|
||||||
|
# own package and the Arch one use ~/.local/share/Steam, Debian's puts it in
|
||||||
|
# ~/.steam/debian-installation, and the Flatpak and the snap each keep it
|
||||||
|
# inside the private tree their sandbox gives them.
|
||||||
|
mca_steam_roots() {
|
||||||
|
local candidates=(
|
||||||
|
"$MCA_XDG_DATA/Steam"
|
||||||
|
"$HOME/.steam/steam"
|
||||||
|
"$HOME/.steam/root"
|
||||||
|
"$HOME/.steam/debian-installation"
|
||||||
|
"$HOME/.var/app/com.valvesoftware.Steam/.local/share/Steam"
|
||||||
|
"$HOME/.var/app/com.valvesoftware.Steam/data/Steam"
|
||||||
|
"$HOME/snap/steam/common/.local/share/Steam"
|
||||||
|
)
|
||||||
|
local dir real
|
||||||
|
local -A seen=()
|
||||||
|
|
||||||
|
for dir in "${candidates[@]}"; do
|
||||||
|
[[ -d $dir ]] || continue
|
||||||
|
real="$(readlink -f -- "$dir" 2>/dev/null)" || continue
|
||||||
|
[[ -n ${seen[$real]+set} ]] && continue
|
||||||
|
seen[$real]=1
|
||||||
|
printf '%s\n' "$real"
|
||||||
|
done
|
||||||
|
}
|
||||||
|
|
||||||
|
# The script to patch inside a Steam installation. Newer clients start the
|
||||||
|
# helper through a wrapper inside the container runtime; older ones exec it
|
||||||
|
# from steamwebhelper.sh directly, and that one forwards its arguments too.
|
||||||
|
mca_steam_script() {
|
||||||
|
local root="$1" f
|
||||||
|
for f in \
|
||||||
|
"$root/ubuntu12_64/steamwebhelper_sniper_wrap.sh" \
|
||||||
|
"$root/ubuntu12_64/steamwebhelper.sh"
|
||||||
|
do
|
||||||
|
[[ -f $f && -w $f ]] && { printf '%s\n' "$f"; return 0; }
|
||||||
|
done
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_steam_installed() {
|
||||||
|
local root
|
||||||
|
while IFS= read -r root; do
|
||||||
|
mca_steam_script "$root" > /dev/null && return 0
|
||||||
|
done < <(mca_steam_roots)
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_steam_running
|
||||||
|
# Steam records its own process id beside its installation while it runs. The
|
||||||
|
# file outlives a crash, so the id is checked rather than believed.
|
||||||
|
mca_steam_running() {
|
||||||
|
local f pid
|
||||||
|
for f in \
|
||||||
|
"$HOME/.steam/steam.pid" \
|
||||||
|
"$HOME/.var/app/com.valvesoftware.Steam/.steam/steam.pid" \
|
||||||
|
"$HOME/snap/steam/common/.steam/steam.pid"
|
||||||
|
do
|
||||||
|
[[ -r $f ]] || continue
|
||||||
|
pid="$(< "$f")"
|
||||||
|
[[ $pid =~ ^[0-9]+$ ]] || continue
|
||||||
|
kill -0 "$pid" 2>/dev/null && return 0
|
||||||
|
done
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_steam_script_patched <script>
|
||||||
|
mca_steam_script_patched() {
|
||||||
|
grep -q -- "$MCA_FEATURE" "$1" 2>/dev/null
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_steam_patched() {
|
||||||
|
local root script
|
||||||
|
while IFS= read -r root; do
|
||||||
|
script="$(mca_steam_script "$root")" || continue
|
||||||
|
mca_steam_script_patched "$script" && return 0
|
||||||
|
done < <(mca_steam_roots)
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_steam_deferred <script>
|
||||||
|
# Whether the patch is being held back rather than simply missing: the script
|
||||||
|
# was patched before, its own copy is back, and Steam is still running. See
|
||||||
|
# mca_steam_apply for why that is left alone.
|
||||||
|
mca_steam_deferred() {
|
||||||
|
[[ -e "$MCA_BACKUPDIR/$(mca_backup_name "$1")" ]] && mca_steam_running
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_steam_waiting
|
||||||
|
# The same question for the status screen, which has no script in hand.
|
||||||
|
mca_steam_waiting() {
|
||||||
|
local root script
|
||||||
|
while IFS= read -r root; do
|
||||||
|
script="$(mca_steam_script "$root")" || continue
|
||||||
|
mca_steam_script_patched "$script" && continue
|
||||||
|
mca_steam_deferred "$script" && return 0
|
||||||
|
done < <(mca_steam_roots)
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
# _mca_steam_exec_line <script>
|
||||||
|
# The line number of the command that starts the web helper: the last
|
||||||
|
# uncommented line that both names steamwebhelper and forwards "$@". Both the
|
||||||
|
# current layout (exec ./steamwebhelper "$@" inside the container wrapper) and
|
||||||
|
# the older one (steamwebhelper.sh handing the arguments to the runtime entry
|
||||||
|
# point) end in exactly that.
|
||||||
|
_mca_steam_exec_line() {
|
||||||
|
awk '
|
||||||
|
/^[[:space:]]*#/ { next }
|
||||||
|
/steamwebhelper/ && /"\$@"/ { n = NR }
|
||||||
|
END { if (n) print n }
|
||||||
|
' "$1" 2>/dev/null
|
||||||
|
}
|
||||||
|
|
||||||
|
# _mca_steam_build <script> <flags> <reclaim: 0|1>
|
||||||
|
# The patched script on stdout: the flags appended to the line that starts the
|
||||||
|
# web helper, and - when asked for - the same number of bytes taken back out of
|
||||||
|
# the script's comments, so that the file Steam finds is the length Steam wrote
|
||||||
|
# down. Everything else - setting up the container runtime, deciding whether
|
||||||
|
# the sandbox can be used - is left alone.
|
||||||
|
#
|
||||||
|
# Comments are eaten from the bottom up, so the header that says what the
|
||||||
|
# script is for is the last thing to lose anything, and the '#' itself always
|
||||||
|
# stays: a line that loses it stops being a comment and starts being a command.
|
||||||
|
# Fails when the comments are too short to pay for the flags.
|
||||||
|
_mca_steam_build() {
|
||||||
|
local script="$1" flags="$2" reclaim="$3" lineno need=0
|
||||||
|
|
||||||
|
lineno="$(_mca_steam_exec_line "$script")"
|
||||||
|
[[ -n $lineno ]] || return 1
|
||||||
|
|
||||||
|
if (( reclaim )); then
|
||||||
|
need="$(printf '%s' " $flags" | wc -c)"
|
||||||
|
need="${need//[^0-9]/}"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# LC_ALL=C so awk counts bytes: a comment with an accent in it is shorter
|
||||||
|
# in characters than it is on disk, and it is the disk that Steam measures.
|
||||||
|
LC_ALL=C awk -v n="$lineno" -v f=" $flags" -v need="$need" '
|
||||||
|
{ lines[NR] = (NR == n ? $0 f : $0) }
|
||||||
|
END {
|
||||||
|
for (i = NR; i >= 2 && need > 0; i--) {
|
||||||
|
if (i == n) continue
|
||||||
|
p = index(lines[i], "#")
|
||||||
|
if (p == 0) continue
|
||||||
|
# Only a line that is nothing but a comment; a trailing one
|
||||||
|
# sits behind a command that has to stay intact.
|
||||||
|
if (substr(lines[i], 1, p - 1) ~ /[^ \t]/) continue
|
||||||
|
can = length(lines[i]) - p
|
||||||
|
if (can <= 0) continue
|
||||||
|
if (can > need) can = need
|
||||||
|
lines[i] = substr(lines[i], 1, length(lines[i]) - can)
|
||||||
|
need -= can
|
||||||
|
}
|
||||||
|
if (need > 0) exit 1
|
||||||
|
for (i = 1; i <= NR; i++) print lines[i]
|
||||||
|
}
|
||||||
|
' "$script"
|
||||||
|
}
|
||||||
|
|
||||||
|
# _mca_steam_same_size <script> <content>
|
||||||
|
# Whether writing that content leaves the file at the size it has now. Measured
|
||||||
|
# rather than worked out: a script without a final newline gains one on the way
|
||||||
|
# through awk, and one byte is all it takes for Steam to notice.
|
||||||
|
_mca_steam_same_size() {
|
||||||
|
local script="$1" content="$2"
|
||||||
|
(( $(wc -c < "$script") == $(printf '%s\n' "$content" | wc -c) ))
|
||||||
|
}
|
||||||
|
|
||||||
|
# _mca_steam_refresh_backup <script>
|
||||||
|
# A client update brings a new version of the script, and the copy kept from
|
||||||
|
# before it is no longer what putting it back means. Only ever done while the
|
||||||
|
# script is unpatched, so the copy that replaces it is Steam's own.
|
||||||
|
_mca_steam_refresh_backup() {
|
||||||
|
local script="$1" name
|
||||||
|
name="$(mca_backup_name "$script")"
|
||||||
|
|
||||||
|
[[ -e "$MCA_BACKUPDIR/$name" ]] || return 0
|
||||||
|
cmp -s -- "$script" "$MCA_BACKUPDIR/$name" && return 0
|
||||||
|
cp -p -- "$script" "$MCA_BACKUPDIR/$name" 2>/dev/null || true
|
||||||
|
}
|
||||||
|
|
||||||
|
# _mca_steam_reneutralise <script> <flags>
|
||||||
|
# An earlier version of this program patched by appending and left the script
|
||||||
|
# longer than Steam expects, which is a patch that only survives because
|
||||||
|
# -noverifyfiles is there to stop Steam looking. If the same flags can be made
|
||||||
|
# to fit, they are: the file goes back to the length and the timestamp Steam
|
||||||
|
# wrote down and stops depending on that switch.
|
||||||
|
#
|
||||||
|
# The new copy is built from the untouched original that was kept when the
|
||||||
|
# script was first patched, never from the patched file - patching a patched
|
||||||
|
# file is how a flag ends up in there twice.
|
||||||
|
_mca_steam_reneutralise() {
|
||||||
|
local script="$1" flags="$2" name copy out
|
||||||
|
|
||||||
|
name="$(mca_backup_name "$script")"
|
||||||
|
copy="$MCA_BACKUPDIR/$name"
|
||||||
|
[[ -f $copy ]] || return 1
|
||||||
|
|
||||||
|
# Already the length Steam expects: there is nothing to gain.
|
||||||
|
(( $(wc -c < "$script") == $(wc -c < "$copy") )) && return 1
|
||||||
|
|
||||||
|
out="$(_mca_steam_build "$copy" "$flags" 1)" || return 1
|
||||||
|
_mca_steam_same_size "$copy" "$out" || return 1
|
||||||
|
|
||||||
|
if mca_write_if_changed "$script" "$out"$'\n'; then
|
||||||
|
MCA_CHANGES=$(( MCA_CHANGES + 1 ))
|
||||||
|
fi
|
||||||
|
chmod +x -- "$script" 2>/dev/null || true
|
||||||
|
touch -r "$copy" -- "$script" 2>/dev/null || true
|
||||||
|
mca_ledger_add steam "$script" "$name"
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_steam_apply
|
||||||
|
# Puts the flags into every Steam installation that has the script, preferring
|
||||||
|
# the patch that keeps the file's size and falling back to the one that does
|
||||||
|
# not. Returns 1 when there is no Steam to patch at all.
|
||||||
|
mca_steam_apply() {
|
||||||
|
local root script backup flags found=0 out neutral
|
||||||
|
|
||||||
|
flags="$(mca_flags)"
|
||||||
|
|
||||||
|
while IFS= read -r root; do
|
||||||
|
script="$(mca_steam_script "$root")" || continue
|
||||||
|
found=1
|
||||||
|
|
||||||
|
if mca_steam_script_patched "$script"; then
|
||||||
|
_mca_steam_reneutralise "$script" "$flags" || true
|
||||||
|
continue
|
||||||
|
fi
|
||||||
|
|
||||||
|
_mca_steam_refresh_backup "$script"
|
||||||
|
|
||||||
|
neutral=1
|
||||||
|
if ! { out="$(_mca_steam_build "$script" "$flags" 1)" \
|
||||||
|
&& _mca_steam_same_size "$script" "$out"; }
|
||||||
|
then
|
||||||
|
neutral=0
|
||||||
|
out="$(_mca_steam_build "$script" "$flags" 0)" || {
|
||||||
|
# A client update changed how the helper is started. Leaving
|
||||||
|
# the file alone is the only safe answer: this script is what
|
||||||
|
# starts Steam's entire interface.
|
||||||
|
mca_note "$(mca_msg "Steam starts its interface in a way this version does not recognise; leaving it alone.")"
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
fi
|
||||||
|
|
||||||
|
# The patch has to grow the file, and it is not patched now but was
|
||||||
|
# before: Steam has just put its own copy back. Patching it again
|
||||||
|
# while the client watches is what turns one size mismatch into an
|
||||||
|
# endless update dialog, and it would not help this session anyway -
|
||||||
|
# the helper is started once, at the start. The patch waits for the
|
||||||
|
# next apply with Steam closed. A patch that keeps the size has
|
||||||
|
# nothing to wait for.
|
||||||
|
if (( ! neutral )) && mca_steam_deferred "$script"; then
|
||||||
|
mca_note "$(mca_msg "Steam is running and has put its own file back; the change waits until Steam is closed.")"
|
||||||
|
continue
|
||||||
|
fi
|
||||||
|
|
||||||
|
backup="$(mca_backup "$script")" || continue
|
||||||
|
if mca_write_if_changed "$script" "$out"$'\n'; then
|
||||||
|
MCA_CHANGES=$(( MCA_CHANGES + 1 ))
|
||||||
|
fi
|
||||||
|
chmod +x -- "$script" 2>/dev/null || true
|
||||||
|
|
||||||
|
# Steam looks at when the file was last written as well as at how big
|
||||||
|
# it is, and the copy taken before the edit still carries the original
|
||||||
|
# timestamp. Putting it back costs nothing and removes the other half
|
||||||
|
# of what the client would notice.
|
||||||
|
touch -r "$MCA_BACKUPDIR/$backup" -- "$script" 2>/dev/null || true
|
||||||
|
|
||||||
|
mca_ledger_add steam "$script" "$backup"
|
||||||
|
done < <(mca_steam_roots)
|
||||||
|
|
||||||
|
(( found ))
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_steam_revert <script> <backup name>
|
||||||
|
mca_steam_revert() {
|
||||||
|
local script="$1" backup="$2"
|
||||||
|
|
||||||
|
if [[ -n $backup && -f "$MCA_BACKUPDIR/$backup" ]]; then
|
||||||
|
if [[ -e $script ]]; then
|
||||||
|
cp -p -- "$MCA_BACKUPDIR/$backup" "$script" 2>/dev/null || true
|
||||||
|
chmod +x -- "$script" 2>/dev/null || true
|
||||||
|
fi
|
||||||
|
rm -f -- "$MCA_BACKUPDIR/$backup"
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
# No backup to fall back on - take the flags back out of the exec line.
|
||||||
|
[[ -f $script ]] || return 1
|
||||||
|
local tmp
|
||||||
|
tmp="$(mktemp "${script}.XXXXXX")" || return 1
|
||||||
|
sed "s| $MCA_FLAG||g" "$script" > "$tmp" && mv -f "$tmp" "$script" || { rm -f "$tmp"; return 1; }
|
||||||
|
chmod +x -- "$script" 2>/dev/null || true
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_steam_flag_position <packaging>
|
||||||
|
# Where Steam's own switch goes on a command line. Straight after the program
|
||||||
|
# for a native or snap entry, because Steam reads its options before the
|
||||||
|
# steam:// argument that the right-click actions pass. For a Flatpak the first
|
||||||
|
# token is flatpak itself, which would take the switch for one of its own and
|
||||||
|
# refuse to start, so there it goes at the end of the arguments - after the
|
||||||
|
# application id, where flatpak hands everything on to Steam.
|
||||||
|
mca_steam_flag_position() {
|
||||||
|
[[ ${1:-native} == flatpak ]] && { printf 'before-fields\n'; return; }
|
||||||
|
printf 'after-program\n'
|
||||||
|
}
|
||||||
|
|
||||||
|
# mca_steam_desktop_apply <id> <source entry> [packaging]
|
||||||
|
# Steam restores its own files at every start unless it is told not to verify
|
||||||
|
# them, so the launcher entry carries that switch.
|
||||||
|
mca_steam_desktop_apply() {
|
||||||
|
mca_desktop_apply "$1" "$2" "$MCA_STEAM_LAUNCH_FLAG" \
|
||||||
|
"$(mca_steam_flag_position "${3:-native}")"
|
||||||
|
}
|
||||||
@@ -0,0 +1,212 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
#
|
||||||
|
# middleclick-autoscroll - middle-click autoscroll for Chromium-based
|
||||||
|
# applications on Linux
|
||||||
|
#
|
||||||
|
# Blink has had Windows-style autoscroll for years, behind a runtime flag that
|
||||||
|
# is not turned on for Linux because middle click is taken by primary-selection
|
||||||
|
# paste there. Turning it on is a matter of one command line argument - the
|
||||||
|
# work is finding every application that needs it, putting the argument
|
||||||
|
# somewhere it survives an update, and doing the same for the two programs that
|
||||||
|
# do not take arguments at all.
|
||||||
|
#
|
||||||
|
# Copyright (C) 2026 Felitendo
|
||||||
|
# SPDX-License-Identifier: GPL-3.0-or-later
|
||||||
|
|
||||||
|
set -uo pipefail
|
||||||
|
|
||||||
|
MCA_LIBDIR="${MCA_LIBDIR:-@LIBDIR@}"
|
||||||
|
|
||||||
|
for _mod in common config detect patch steam apply menu; do
|
||||||
|
# shellcheck source=/dev/null
|
||||||
|
if ! source "$MCA_LIBDIR/$_mod.sh"; then
|
||||||
|
printf 'middleclick-autoscroll: cannot load %s/%s.sh\n' "$MCA_LIBDIR" "$_mod" >&2
|
||||||
|
exit 14
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
unset _mod
|
||||||
|
|
||||||
|
# Nothing here writes outside $HOME, so running it as root would patch root's
|
||||||
|
# own applications and leave the actual user without any.
|
||||||
|
if [[ $EUID -eq 0 && -z ${MCA_ALLOW_ROOT:-} ]]; then
|
||||||
|
printf 'middleclick-autoscroll: run this as your own user, not as root.\n' >&2
|
||||||
|
exit 2
|
||||||
|
fi
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Commands
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
mca_do_enable() {
|
||||||
|
mca_config_set Enabled yes || {
|
||||||
|
mca_bad "$(mca_msg "Could not save the setting.")"
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
mca_config_load
|
||||||
|
|
||||||
|
mca_apply
|
||||||
|
|
||||||
|
if [[ $CFG_WATCH == yes ]]; then
|
||||||
|
if mca_watch_available; then
|
||||||
|
mca_watch_enable || mca_note "$(mca_msg "Could not start the watcher for newly installed applications.")"
|
||||||
|
else
|
||||||
|
mca_note "$(mca_msg "No systemd user session - newly installed applications will not be picked up on their own.")"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
mca_ok "$(mca_msg "Autoscroll is on for %d applications." "$MCA_N_ON")"
|
||||||
|
|
||||||
|
if [[ $CFG_STEAM == yes ]] && mca_steam_installed; then
|
||||||
|
mca_note "$(mca_msg "Steam's launcher now skips its file check, which is what keeps the change from being undone at every start.")"
|
||||||
|
fi
|
||||||
|
|
||||||
|
mca_note "$(mca_msg "Applications that are already running pick this up when they are restarted.")"
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_do_disable() {
|
||||||
|
mca_config_set Enabled no || {
|
||||||
|
mca_bad "$(mca_msg "Could not save the setting.")"
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_revert
|
||||||
|
mca_watch_disable
|
||||||
|
|
||||||
|
mca_ok "$(mca_msg "Autoscroll is off and everything that was changed has been put back.")"
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_do_apply() {
|
||||||
|
local rebuild=0 arg
|
||||||
|
|
||||||
|
for arg in "$@"; do
|
||||||
|
case "$arg" in
|
||||||
|
--rebuild) rebuild=1 ;;
|
||||||
|
--quiet) MCA_QUIET=1 ;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
|
||||||
|
mca_config_load
|
||||||
|
|
||||||
|
if [[ $CFG_ENABLED != yes ]]; then
|
||||||
|
# Called by the watcher while switched off: there is nothing to do, and
|
||||||
|
# nothing to complain about either.
|
||||||
|
[[ -n $MCA_QUIET ]] && return 0
|
||||||
|
mca_note "$(mca_msg "Autoscroll is off. Turn it on first.")"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Start from a clean slate. Needed after a settings change, which can take
|
||||||
|
# an application out of scope as well as bring one in and where only a full
|
||||||
|
# undo can tell the difference, and it is what makes the repair a repair:
|
||||||
|
# whatever drifted is written again rather than left because it is "already
|
||||||
|
# applied".
|
||||||
|
#
|
||||||
|
# The watcher never does this. Rewriting files that are already correct
|
||||||
|
# would change their timestamps, and it is watching those directories.
|
||||||
|
if (( rebuild )); then
|
||||||
|
mca_revert
|
||||||
|
fi
|
||||||
|
|
||||||
|
mca_apply
|
||||||
|
|
||||||
|
if (( rebuild )); then
|
||||||
|
mca_ok "$(mca_msg "Applied again to %d applications." "$MCA_N_ON")"
|
||||||
|
mca_say " $(mca_msg "Applications that are already running pick this up when they are restarted.")"
|
||||||
|
elif (( MCA_CHANGES )); then
|
||||||
|
mca_ok "$(mca_msg "Applied to %d applications." "$MCA_N_ON")"
|
||||||
|
mca_say " $(mca_msg "Applications that are already running pick this up when they are restarted.")"
|
||||||
|
else
|
||||||
|
mca_ok "$(mca_msg "Already applied to %d applications." "$MCA_N_ON")"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [[ $CFG_WATCH == yes ]] && mca_watch_available; then
|
||||||
|
if mca_watch_enabled; then
|
||||||
|
mca_watch_refresh
|
||||||
|
else
|
||||||
|
mca_watch_enable || true
|
||||||
|
fi
|
||||||
|
elif [[ $CFG_WATCH != yes ]] && mca_watch_enabled; then
|
||||||
|
mca_watch_disable
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_do_status() {
|
||||||
|
mca_config_load
|
||||||
|
mca_head " $MCA_PRETTY"
|
||||||
|
mca_ui_status
|
||||||
|
printf '\n'
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_do_list() {
|
||||||
|
local i route label pad
|
||||||
|
|
||||||
|
mca_config_load
|
||||||
|
mca_scan_once
|
||||||
|
mca_count_routes
|
||||||
|
|
||||||
|
if (( ${#MCA_IDS[@]} == 0 )); then
|
||||||
|
mca_note "$(mca_msg "No Chromium-based applications found.")"
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
mca_head " $(mca_msg "Applications")"
|
||||||
|
|
||||||
|
for i in "${!MCA_IDS[@]}"; do
|
||||||
|
route="${MCA_ROUTES[i]}"
|
||||||
|
label="${MCA_NAMES[i]}"
|
||||||
|
pad=$(( 34 - ${#label} ))
|
||||||
|
(( pad < 0 )) && pad=0
|
||||||
|
printf ' %s%*s %s\n' "$label" "$pad" '' "$(mca_route_label "$route")"
|
||||||
|
done
|
||||||
|
printf '\n'
|
||||||
|
}
|
||||||
|
|
||||||
|
mca_do_help() {
|
||||||
|
cat <<- EOF
|
||||||
|
$MCA_PRETTY $MCA_VERSION
|
||||||
|
|
||||||
|
$(mca_msg "Usage: middleclick-autoscroll [command]")
|
||||||
|
|
||||||
|
$(mca_msg "Commands:")
|
||||||
|
enable $(mca_msg "Turn autoscroll on")
|
||||||
|
disable $(mca_msg "Turn it off and put everything back")
|
||||||
|
apply $(mca_msg "Apply to anything installed since the last run")
|
||||||
|
apply --rebuild $(mca_msg "Take everything back and apply it again")
|
||||||
|
status $(mca_msg "Show what is covered")
|
||||||
|
list $(mca_msg "List every application that was found")
|
||||||
|
-h, --help $(mca_msg "Show this help")
|
||||||
|
-V, --version $(mca_msg "Show the version")
|
||||||
|
|
||||||
|
$(mca_msg "Without a command an interactive menu is shown.")
|
||||||
|
EOF
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# Dispatch
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
main() {
|
||||||
|
local cmd="${1:-}"
|
||||||
|
[[ $# -gt 0 ]] && shift
|
||||||
|
|
||||||
|
case "$cmd" in
|
||||||
|
enable) mca_do_enable "$@" ;;
|
||||||
|
disable) mca_do_disable "$@" ;;
|
||||||
|
apply|refresh) mca_do_apply "$@" ;;
|
||||||
|
status) mca_do_status "$@" ;;
|
||||||
|
list) mca_do_list "$@" ;;
|
||||||
|
|
||||||
|
-h|--help|help) mca_do_help ;;
|
||||||
|
-V|--version) printf '%s %s\n' "$MCA_NAME" "$MCA_VERSION" ;;
|
||||||
|
|
||||||
|
'') mca_ui_menu ;;
|
||||||
|
*)
|
||||||
|
mca_bad "$(mca_msg "Unknown command: %s" "$cmd")"
|
||||||
|
printf '\n'
|
||||||
|
mca_do_help
|
||||||
|
exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
|
main "$@"
|
||||||
Reference in new issue
Block a user