Altogether is a CLI tool to synchronize configuration files between 2 major keyboard launchers -- Alfred and Albert. So the target user is who adopts both Mac and Linux on a daily basis, or someone needs to migrate one's config to the another.
Supported configuration files are the ones relating to:
- Web search
- Snippets (refer to #13)
Go ahead and grab Homebrewed altogether
:
brew install announce/homebrew-altogether/altogether
If you are using Arch Linux, AUR Package is recommended.
Install altogether
with AUR helper such as yay
:
yay -Syu altogether
Unless specified above, one of the simplest ways for your platform is:
- Download package from according to platform:
- macOS:
darwin-amd64.tar.gz
- Linux:
linux-amd64.tar.gz
- macOS:
- Extract the compressed tarball and place
altogether
to somewhere underPATH
directory:
curl -L https://github.com/announce/altogether/releases/download/v0.1.2/linux-amd64.tar.gz | tar -zxvf - \
&& mv ./linux-amd64/altogether /usr/local/bin \
&& altogether --help
There are 2 ways to specify arguments. One is to use command options like below:
altogether sync-web --dry-run --alfred-path ~/.config/Alfred.alfredpreferences --albert-path ~/.config/testdata/albert
In the other way, you can specify parameters in environmental variables:
AL2_ALFRED_PATH
: a path to Alfred's config directoryAL2_ALBERT_PATH
: a path to Albert's config directoryAL2_DRY_RUN
: set1
to dump merged configurations in TSV style without actual file changeAL2_VERBOSE
: set1
to print out detailed logs
For instance, you can execute commands like as following:
export AL2_ALFRED_PATH="${HOME}/.config/Alfred.alfredpreferences"
export AL2_ALBERT_PATH="${HOME}/.config/albert"
export AL2_DRY_RUN=1
export AL2_VERBOSE=1
./altogether sync-web
Consider setting a Systemd configuration to run altogether
automatically.
- Place unit files to
~/.config/systemd/user/
- You can find sample files under
sample/systemd/
in this repository
- You can find sample files under
- Register
altogether
and browse the logs like below:
systemctl --user daemon-reload && systemctl --user restart altogether
journalctl --user -xe -u altogether
- 3.8.x
- 0.16.x
Here's how to get started!
- Install Docker (verified version:
18.09.1-ce
) - Build a container and start debugging:
./script/ci.sh init
./script/ci.sh ci
Related repositories: