https://github.com/cheonjaeung/fzf-android
Bash and Zsh key bindings for Android SDK CLI tools, inspired by fzf-git.
https://github.com/cheonjaeung/fzf-android
adb android bash fzf key-bindings zsh
Last synced: 24 days ago
JSON representation
Bash and Zsh key bindings for Android SDK CLI tools, inspired by fzf-git.
- Host: GitHub
- URL: https://github.com/cheonjaeung/fzf-android
- Owner: cheonjaeung
- License: apache-2.0
- Created: 2026-03-08T05:37:52.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-07T14:07:25.000Z (3 months ago)
- Last Synced: 2026-04-07T16:10:10.168Z (3 months ago)
- Topics: adb, android, bash, fzf, key-bindings, zsh
- Language: Shell
- Homepage:
- Size: 4.85 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
- Agents: AGENTS.md
Awesome Lists containing this project
README
# fzf-android
Bash and Zsh key bindings for Android SDK CLI, inspired by [fzf-git](https://github.com/junegunn/fzf-git.sh).
## Installation
This tool heavily depends on [fzf](https://github.com/junegunn/fzf) and Android SDK command line tools.
Check if the tools are installed in your environment.
### HomeBrew
1. Add Cheon Jaeung's Tap.
```sh
brew tap cheonjaeung/tap
```
2. Install fzf-android using brew.
```sh
brew install fzf-android
```
3. `source` the shell script to your `.bashrc` or `.zshrc`.
```sh
echo "source $(brew --prefix)/share/fzf-android/fzf-android.sh" >> ~/.zshrc
```
### Manual
1. Download or clone the project.
```sh
git clone https://github.com/cheonjaeung/fzf-android.git ~/.fzf-android
```
2. `source` the shell script to your `.bashrc` or `.zshrc`.
```sh
echo "source ~/.fzf-android/fzf-android.sh" >> ~/.zshrc
```
3. Restart your shell or apply the recent configuration.
```sh
source ~/.zshrc
```
## Usage
You can open the selector user interface using the following key bindings.
- CTRL-A?: Show the help.
- CTRL-ACTRL-E: Show the d**e**vice list.
- CTRL-ACTRL-V: Show the android **v**irtual device list.
- CTRL-ACTRL-P: Show the installed **p**ackage list.
- CTRL-ACTRL-F: Show the device **f**ile list.
> [!TIP]
> You can use CTRL-A{key} instead of CTRL-ACTRL-{key}
## Examples
### Device Serials
Example of getting API level in the specific device's ADB shell.
### Emulator
Example of starting a virtual device.
## License
This project is licensed under the Apache License 2.0.
```
Copyright 2026 Cheon Jaeung
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```