baska-explorer 3.0.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (20) hide show
  1. baska_explorer-3.0.1/CHANGELOG.md +51 -0
  2. baska_explorer-3.0.1/LICENSE +57 -0
  3. baska_explorer-3.0.1/MANIFEST.in +2 -0
  4. baska_explorer-3.0.1/PKG-INFO +251 -0
  5. baska_explorer-3.0.1/README.en.md +59 -0
  6. baska_explorer-3.0.1/README.md +229 -0
  7. baska_explorer-3.0.1/VERSION +1 -0
  8. baska_explorer-3.0.1/explorer.sh +1407 -0
  9. baska_explorer-3.0.1/pyproject.toml +40 -0
  10. baska_explorer-3.0.1/setup.cfg +4 -0
  11. baska_explorer-3.0.1/src/baska_explorer/__init__.py +2 -0
  12. baska_explorer-3.0.1/src/baska_explorer/__main__.py +5 -0
  13. baska_explorer-3.0.1/src/baska_explorer/cli.py +37 -0
  14. baska_explorer-3.0.1/src/baska_explorer/explorer.sh +1407 -0
  15. baska_explorer-3.0.1/src/baska_explorer.egg-info/PKG-INFO +251 -0
  16. baska_explorer-3.0.1/src/baska_explorer.egg-info/SOURCES.txt +18 -0
  17. baska_explorer-3.0.1/src/baska_explorer.egg-info/dependency_links.txt +1 -0
  18. baska_explorer-3.0.1/src/baska_explorer.egg-info/entry_points.txt +4 -0
  19. baska_explorer-3.0.1/src/baska_explorer.egg-info/top_level.txt +1 -0
  20. baska_explorer-3.0.1/tests/test_pypi_packaging.py +44 -0
baska_explorer-3.0.1/CHANGELOG.md ADDED
@@ -0,0 +1,51 @@
1
+ # Changelog
2
+
3
+ ## Unreleased
4
+
5
+ No unreleased changes yet.
6
+
7
+ ## 3.0.1 - 2026-11-04 (PyPI packaging candidate)
8
+
9
+ ### Added
10
+ - Standalone PyPI distribution `baska-explorer` with a bundled copy of the Bash application.
11
+ - Safe Python launchers for `baska-explorer`, `terminal-explorer` and `texplorer`.
12
+ - Automated wheel and source-distribution builds, tests and release workflow.
13
+
14
+ ### Compatibility
15
+ - Keep the original Bash installation method unchanged.
16
+ - `pip` does not install OS dependencies such as Bash, fzf, tree and bat/batcat.
17
+ - Windows remains unsupported.
18
+ - This is a packaging candidate; it is not published to PyPI until approved.
19
+
20
+
21
+ ## 3.0.0 - 2026-08-29
22
+
23
+ ### Added
24
+
25
+ - Universal Termux + Linux runtime detection.
26
+ - Linux distribution/package-manager diagnostics.
27
+ - Installer support for `pkg`, `apt-get`, `dnf`, `yum`, `pacman`, `zypper`, `apk`, and `xbps-install`.
28
+ - Automatic `bat` / `batcat` compatibility.
29
+ - Clipboard backend detection for Termux, Wayland (`wl-copy`), and X11 (`xclip` / `xsel`).
30
+ - `$EDITOR` / nano / vim / vi editor fallback.
31
+ - User-local Linux installation under `~/.local`.
32
+ - Non-destructive bookmark migration from the old Termux Explorer config directory.
33
+ - Protection for important Linux system roots.
34
+
35
+ ### Changed
36
+
37
+ - Project branding changed from Termux Explorer to Terminal Explorer because the application is no longer Termux-only.
38
+ - Temporary files now use `$TMPDIR`, Termux `$PREFIX/tmp`, or `/tmp` as appropriate.
39
+ - Dependency messages now match the detected package manager.
40
+ - `--doctor` now reports platform, package manager, preview command, and clipboard backend.
41
+
42
+ ### Preserved
43
+
44
+ - Existing fzf navigation and preview workflow.
45
+ - File/folder action menus.
46
+ - Internal copy/cut/paste clipboard.
47
+ - Search, bookmarks, sorting, hidden-file toggle, chmod, compression/extraction, Git info, and safety confirmations.
48
+
49
+ ## 3.0
50
+
51
+ Original Termux Explorer Ultimate v3.0 feature set.
baska_explorer-3.0.1/LICENSE ADDED
@@ -0,0 +1,57 @@
1
+ BASKA-PRO PERSONAL USE LICENSE
2
+ Version 1.0
3
+
4
+ Copyright (c) 2026 Lathif Baska
5
+ All Rights Reserved.
6
+
7
+ Permission is granted to individuals to view, download, run, study, test,
8
+ and modify this software solely for personal, private, and non-commercial use.
9
+
10
+ You may make reasonable private backup copies and modifications for your own
11
+ personal use.
12
+
13
+ Unless explicit prior written permission is granted by the copyright holder,
14
+ you may NOT:
15
+
16
+ 1. Redistribute, republish, mirror, upload, or otherwise make copies of this
17
+ software or substantial portions of its source code available to third
18
+ parties.
19
+
20
+ 2. Sell, rent, lease, sublicense, license, monetize, or commercially exploit
21
+ this software or any substantial portion of it.
22
+
23
+ 3. Rebrand, rename, or present this software or substantial portions of it as
24
+ your own work or product.
25
+
26
+ 4. Incorporate this software or substantial portions of it into another
27
+ distributed, commercial, paid, or publicly offered product or service.
28
+
29
+ 5. Offer this software, modified or unmodified, as a hosted service,
30
+ Software-as-a-Service (SaaS), paid service, commercial service, or other
31
+ revenue-generating service.
32
+
33
+ 6. Remove or alter copyright notices, attribution notices, or this license.
34
+
35
+ Modification for personal and private use is permitted, but distribution of
36
+ modified versions is not permitted without prior written permission from the
37
+ copyright holder.
38
+
39
+ No patent, trademark, branding, or other intellectual-property rights are
40
+ granted except for the limited personal-use rights expressly stated above.
41
+
42
+ For redistribution, commercial use, integration into another distributed
43
+ product, or any use outside the permissions above, prior written permission
44
+ from the copyright holder is required.
45
+
46
+ Permission requests may be submitted through:
47
+
48
+ https://github.com/baska-pro
49
+
50
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
51
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
52
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
53
+
54
+ IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES, OR
55
+ OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE,
56
+ ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
57
+ DEALINGS IN THE SOFTWARE.
baska_explorer-3.0.1/MANIFEST.in ADDED
@@ -0,0 +1,2 @@
1
+ include README.md README.en.md CHANGELOG.md VERSION LICENSE explorer.sh
2
+ recursive-include src/baska_explorer *.sh
baska_explorer-3.0.1/PKG-INFO ADDED
@@ -0,0 +1,251 @@
1
+ Metadata-Version: 2.4
2
+ Name: baska-explorer
3
+ Version: 3.0.1
4
+ Summary: Interactive Bash and fzf file manager for Linux and Termux
5
+ Author: Lathif Baska
6
+ License-Expression: LicenseRef-BASKA-Pro-Personal-Use-1.0
7
+ Project-URL: Homepage, https://github.com/baska-pro/terminal-explorer
8
+ Project-URL: Repository, https://github.com/baska-pro/terminal-explorer
9
+ Project-URL: Issues, https://github.com/baska-pro/terminal-explorer/issues
10
+ Keywords: terminal,file-manager,bash,fzf,linux,termux,explorer
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Environment :: Console
13
+ Classifier: Operating System :: POSIX :: Linux
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Programming Language :: Python :: 3 :: Only
16
+ Classifier: Topic :: System :: Filesystems
17
+ Classifier: Topic :: Utilities
18
+ Requires-Python: >=3.10
19
+ Description-Content-Type: text/markdown
20
+ License-File: LICENSE
21
+ Dynamic: license-file
22
+
23
+ <!-- repo-banner:start -->
24
+ <p align="center">
25
+ <img src="https://raw.githubusercontent.com/baska-pro/terminal-explorer/main/assets/banner.png" alt="Terminal Explorer Banner" width="100%">
26
+ </p>
27
+ <!-- repo-banner:end -->
28
+
29
+ # Terminal Explorer
30
+
31
+ [![Release](https://img.shields.io/github/v/release/baska-pro/terminal-explorer?style=flat-square)](https://github.com/baska-pro/terminal-explorer/releases/latest)
32
+ [![CI](https://github.com/baska-pro/terminal-explorer/actions/workflows/ci.yml/badge.svg)](https://github.com/baska-pro/terminal-explorer/actions/workflows/ci.yml)
33
+ [![License: Baska-Pro Personal Use](https://img.shields.io/badge/License-Baska--Pro%20Personal%20Use%201.0-blue.svg?style=flat-square)](LICENSE)
34
+ [![Platform](https://img.shields.io/badge/platform-Termux%20%7C%20Linux-2ea44f?style=flat-square)](#platform)
35
+
36
+
37
+ File manager interaktif berbasis **Bash + fzf** untuk **Termux dan Linux**.
38
+
39
+ > Current release: **v3.0.1** — universal untuk Termux dan Linux.
40
+
41
+ ## Platform
42
+
43
+ Didukung:
44
+
45
+ - Termux / Android
46
+ - Debian / Ubuntu
47
+ - Fedora / RHEL
48
+ - Arch Linux / Manjaro
49
+ - openSUSE
50
+ - Alpine Linux
51
+ - Void Linux
52
+ - Linux generic selama dependency tersedia
53
+
54
+ ## Fitur
55
+
56
+ Fitur utama dari Termux Explorer tetap dipertahankan:
57
+
58
+ - navigasi folder interaktif dengan `fzf`;
59
+ - preview file/folder/symlink;
60
+ - buat file dan folder;
61
+ - edit file;
62
+ - jalankan script/file executable;
63
+ - info file/folder;
64
+ - chmod;
65
+ - copy, cut, paste, move, rename, delete;
66
+ - clipboard internal;
67
+ - copy isi file ke clipboard sistem;
68
+ - bookmark;
69
+ - pencarian nama dan isi file;
70
+ - sort berdasarkan nama, ukuran, tanggal;
71
+ - hidden files;
72
+ - kompres dan ekstrak archive;
73
+ - deteksi Git repository;
74
+ - perlindungan path penting;
75
+ - `--doctor`, `--help`, dan `--version`.
76
+
77
+ ## Install melalui PyPI (Termux / Linux)
78
+
79
+ Proyek ini juga disiapkan menjadi paket Python bernama **`baska-explorer`**. `pip` memasang aplikasi Bash beserta launcher lokalnya tanpa menjalankan installer GitHub, `sudo`, `apt`, atau `pkg`. Nama paket baru dapat digunakan setelah publikasi PyPI disetujui dan berhasil.
80
+
81
+ Persyaratan: Python 3.10+, Bash, fzf, tree, file, findutils, coreutils, gawk, grep, sed, serta bat/batcat. Dependency sistem **tidak** otomatis dipasang oleh pip.
82
+
83
+ Termux:
84
+
85
+ ```bash
86
+ pkg install python bash fzf tree file findutils coreutils gawk grep sed bat
87
+ python -m pip install baska-explorer
88
+ baska-explorer --doctor
89
+ baska-explorer
90
+ ```
91
+
92
+ Debian/Ubuntu:
93
+
94
+ ```bash
95
+ sudo apt install -y pipx bash fzf tree file findutils coreutils gawk grep sed bat
96
+ pipx install baska-explorer
97
+ baska-explorer --doctor
98
+ baska-explorer
99
+ ```
100
+
101
+ Perintah alternatif: `terminal-explorer` dan `texplorer`. Jika pernah memasang dengan `install.sh`, cek executable mana yang aktif melalui `command -v terminal-explorer` karena PATH bisa menunjuk instalasi lama. Windows belum didukung.
102
+
103
+ ## Install cepat
104
+
105
+ ### Termux / Linux
106
+
107
+ ```bash
108
+ curl -fsSL https://raw.githubusercontent.com/baska-pro/terminal-explorer/main/install.sh | bash
109
+ ```
110
+
111
+ Installer mendeteksi package manager:
112
+
113
+ ```text
114
+ pkg
115
+ apt
116
+ dnf / yum
117
+ pacman
118
+ zypper
119
+ apk
120
+ xbps
121
+ ```
122
+
123
+ ### Dari clone
124
+
125
+ ```bash
126
+ git clone https://github.com/baska-pro/terminal-explorer.git
127
+ cd terminal-explorer
128
+ chmod +x install.sh
129
+ ./install.sh
130
+ ```
131
+
132
+ ## Jalankan
133
+
134
+ ```bash
135
+ terminal-explorer
136
+ ```
137
+
138
+ Alias:
139
+
140
+ ```bash
141
+ texplorer
142
+ ```
143
+
144
+ Buka folder tertentu:
145
+
146
+ ```bash
147
+ texplorer ~/projects
148
+ ```
149
+
150
+ Diagnostik:
151
+
152
+ ```bash
153
+ texplorer --doctor
154
+ ```
155
+
156
+ ## Clipboard
157
+
158
+ Backend dipilih otomatis:
159
+
160
+ | Environment | Backend |
161
+ |---|---|
162
+ | Termux | `termux-clipboard-set` |
163
+ | Linux Wayland | `wl-copy` |
164
+ | Linux X11 | `xclip` |
165
+ | Linux X11 alternatif | `xsel` |
166
+
167
+ Clipboard sistem bersifat opsional. Clipboard internal copy/cut/paste tetap berfungsi tanpa backend tersebut.
168
+
169
+ ## `bat` di Debian/Ubuntu
170
+
171
+ Pada sebagian versi Debian/Ubuntu executable paket `bat` bernama `batcat`.
172
+
173
+ Terminal Explorer mendeteksi keduanya otomatis:
174
+
175
+ ```text
176
+ bat
177
+ batcat
178
+ ```
179
+
180
+ Tidak perlu membuat symlink manual.
181
+
182
+ ## Install path
183
+
184
+ Termux:
185
+
186
+ ```text
187
+ $PREFIX/share/terminal-explorer/explorer.sh
188
+ $PREFIX/bin/terminal-explorer
189
+ $PREFIX/bin/texplorer
190
+ ```
191
+
192
+ Linux:
193
+
194
+ ```text
195
+ ~/.local/share/terminal-explorer/explorer.sh
196
+ ~/.local/bin/terminal-explorer
197
+ ~/.local/bin/texplorer
198
+ ```
199
+
200
+ Config:
201
+
202
+ ```text
203
+ ~/.config/terminal-explorer/
204
+ ```
205
+
206
+ Jika bookmark lama ditemukan di:
207
+
208
+ ```text
209
+ ~/.config/termux-explorer/bookmarks
210
+ ```
211
+
212
+ bookmark akan disalin otomatis saat config baru belum ada.
213
+
214
+
215
+ ## Release
216
+
217
+ Versi stabil saat ini:
218
+
219
+ ```text
220
+ v3.0.1
221
+ ```
222
+
223
+ Lihat [GitHub Releases](https://github.com/baska-pro/terminal-explorer/releases/latest) untuk source archive dan asset release.
224
+
225
+ ## Uninstall
226
+
227
+ ```bash
228
+ ./uninstall.sh
229
+ ```
230
+
231
+ Hapus juga config:
232
+
233
+ ```bash
234
+ ./uninstall.sh --purge
235
+ ```
236
+
237
+ ## Safety
238
+
239
+ Sebelum delete, rename overwrite, move overwrite, dan operasi destruktif lain, aplikasi meminta konfirmasi.
240
+
241
+ Path penting seperti `/`, `/etc`, `/usr`, `/var`, `$HOME`, dan root Termux dilindungi dari operasi delete melalui menu.
242
+
243
+ Baca [docs/SAFETY.md](docs/SAFETY.md).
244
+
245
+ ## License
246
+
247
+ BASKA-PRO PERSONAL USE LICENSE
248
+ Version 1.0
249
+
250
+ Copyright (c) 2026 Lathif Baska
251
+ All Rights Reserved.
baska_explorer-3.0.1/README.en.md ADDED
@@ -0,0 +1,59 @@
1
+ <!-- repo-banner:start -->
2
+ <p align="center">
3
+ <img src="https://raw.githubusercontent.com/baska-pro/terminal-explorer/main/assets/banner.png" alt="Terminal Explorer Banner" width="100%">
4
+ </p>
5
+ <!-- repo-banner:end -->
6
+
7
+ # Terminal Explorer
8
+
9
+ [![Release](https://img.shields.io/github/v/release/baska-pro/terminal-explorer?style=flat-square)](https://github.com/baska-pro/terminal-explorer/releases/latest)
10
+ [![CI](https://github.com/baska-pro/terminal-explorer/actions/workflows/ci.yml/badge.svg)](https://github.com/baska-pro/terminal-explorer/actions/workflows/ci.yml)
11
+ [![License: Baska-Pro Personal Use](https://img.shields.io/badge/License-Baska--Pro%20Personal%20Use%201.0-blue.svg?style=flat-square)](LICENSE)
12
+
13
+ Interactive **Bash + fzf** file manager for **Termux and Linux**.
14
+
15
+ Current stable release: **v3.0.1**, with universal support for Termux and Linux.
16
+
17
+ Supported environments include Termux, Debian/Ubuntu, Fedora/RHEL, Arch/Manjaro, openSUSE, Alpine, Void Linux, and generic Linux systems with the required commands installed.
18
+
19
+ ## Install from PyPI (Linux and Termux)
20
+
21
+ The separately packaged `baska-explorer` distribution includes the original Bash script and installs the commands `baska-explorer`, `terminal-explorer`, and `texplorer`. It does not install OS packages or download executable code during setup. Install bash, fzf, tree, file, GNU tools, and bat/batcat separately.
22
+
23
+ ```bash
24
+ python -m pip install baska-explorer
25
+ baska-explorer --doctor
26
+ baska-explorer
27
+ ```
28
+
29
+ For Linux application isolation, prefer `pipx install baska-explorer`. Windows is unsupported.
30
+
31
+ ## Quick install
32
+
33
+ ```bash
34
+ curl -fsSL https://raw.githubusercontent.com/baska-pro/terminal-explorer/main/install.sh | bash
35
+ ```
36
+
37
+ Run:
38
+
39
+ ```bash
40
+ terminal-explorer
41
+ ```
42
+
43
+ Alias:
44
+
45
+ ```bash
46
+ texplorer
47
+ ```
48
+
49
+ Diagnostics:
50
+
51
+ ```bash
52
+ texplorer --doctor
53
+ ```
54
+
55
+ The installer detects `pkg`, `apt-get`, `dnf`, `yum`, `pacman`, `zypper`, `apk`, and `xbps-install`.
56
+
57
+ The application automatically supports `bat` or Debian's `batcat`, and system clipboard backends including Termux:API, `wl-copy`, `xclip`, and `xsel`.
58
+
59
+ See [README.md](README.md) for the Indonesian documentation.
baska_explorer-3.0.1/README.md ADDED
@@ -0,0 +1,229 @@
1
+ <!-- repo-banner:start -->
2
+ <p align="center">
3
+ <img src="https://raw.githubusercontent.com/baska-pro/terminal-explorer/main/assets/banner.png" alt="Terminal Explorer Banner" width="100%">
4
+ </p>
5
+ <!-- repo-banner:end -->
6
+
7
+ # Terminal Explorer
8
+
9
+ [![Release](https://img.shields.io/github/v/release/baska-pro/terminal-explorer?style=flat-square)](https://github.com/baska-pro/terminal-explorer/releases/latest)
10
+ [![CI](https://github.com/baska-pro/terminal-explorer/actions/workflows/ci.yml/badge.svg)](https://github.com/baska-pro/terminal-explorer/actions/workflows/ci.yml)
11
+ [![License: Baska-Pro Personal Use](https://img.shields.io/badge/License-Baska--Pro%20Personal%20Use%201.0-blue.svg?style=flat-square)](LICENSE)
12
+ [![Platform](https://img.shields.io/badge/platform-Termux%20%7C%20Linux-2ea44f?style=flat-square)](#platform)
13
+
14
+
15
+ File manager interaktif berbasis **Bash + fzf** untuk **Termux dan Linux**.
16
+
17
+ > Current release: **v3.0.1** — universal untuk Termux dan Linux.
18
+
19
+ ## Platform
20
+
21
+ Didukung:
22
+
23
+ - Termux / Android
24
+ - Debian / Ubuntu
25
+ - Fedora / RHEL
26
+ - Arch Linux / Manjaro
27
+ - openSUSE
28
+ - Alpine Linux
29
+ - Void Linux
30
+ - Linux generic selama dependency tersedia
31
+
32
+ ## Fitur
33
+
34
+ Fitur utama dari Termux Explorer tetap dipertahankan:
35
+
36
+ - navigasi folder interaktif dengan `fzf`;
37
+ - preview file/folder/symlink;
38
+ - buat file dan folder;
39
+ - edit file;
40
+ - jalankan script/file executable;
41
+ - info file/folder;
42
+ - chmod;
43
+ - copy, cut, paste, move, rename, delete;
44
+ - clipboard internal;
45
+ - copy isi file ke clipboard sistem;
46
+ - bookmark;
47
+ - pencarian nama dan isi file;
48
+ - sort berdasarkan nama, ukuran, tanggal;
49
+ - hidden files;
50
+ - kompres dan ekstrak archive;
51
+ - deteksi Git repository;
52
+ - perlindungan path penting;
53
+ - `--doctor`, `--help`, dan `--version`.
54
+
55
+ ## Install melalui PyPI (Termux / Linux)
56
+
57
+ Proyek ini juga disiapkan menjadi paket Python bernama **`baska-explorer`**. `pip` memasang aplikasi Bash beserta launcher lokalnya tanpa menjalankan installer GitHub, `sudo`, `apt`, atau `pkg`. Nama paket baru dapat digunakan setelah publikasi PyPI disetujui dan berhasil.
58
+
59
+ Persyaratan: Python 3.10+, Bash, fzf, tree, file, findutils, coreutils, gawk, grep, sed, serta bat/batcat. Dependency sistem **tidak** otomatis dipasang oleh pip.
60
+
61
+ Termux:
62
+
63
+ ```bash
64
+ pkg install python bash fzf tree file findutils coreutils gawk grep sed bat
65
+ python -m pip install baska-explorer
66
+ baska-explorer --doctor
67
+ baska-explorer
68
+ ```
69
+
70
+ Debian/Ubuntu:
71
+
72
+ ```bash
73
+ sudo apt install -y pipx bash fzf tree file findutils coreutils gawk grep sed bat
74
+ pipx install baska-explorer
75
+ baska-explorer --doctor
76
+ baska-explorer
77
+ ```
78
+
79
+ Perintah alternatif: `terminal-explorer` dan `texplorer`. Jika pernah memasang dengan `install.sh`, cek executable mana yang aktif melalui `command -v terminal-explorer` karena PATH bisa menunjuk instalasi lama. Windows belum didukung.
80
+
81
+ ## Install cepat
82
+
83
+ ### Termux / Linux
84
+
85
+ ```bash
86
+ curl -fsSL https://raw.githubusercontent.com/baska-pro/terminal-explorer/main/install.sh | bash
87
+ ```
88
+
89
+ Installer mendeteksi package manager:
90
+
91
+ ```text
92
+ pkg
93
+ apt
94
+ dnf / yum
95
+ pacman
96
+ zypper
97
+ apk
98
+ xbps
99
+ ```
100
+
101
+ ### Dari clone
102
+
103
+ ```bash
104
+ git clone https://github.com/baska-pro/terminal-explorer.git
105
+ cd terminal-explorer
106
+ chmod +x install.sh
107
+ ./install.sh
108
+ ```
109
+
110
+ ## Jalankan
111
+
112
+ ```bash
113
+ terminal-explorer
114
+ ```
115
+
116
+ Alias:
117
+
118
+ ```bash
119
+ texplorer
120
+ ```
121
+
122
+ Buka folder tertentu:
123
+
124
+ ```bash
125
+ texplorer ~/projects
126
+ ```
127
+
128
+ Diagnostik:
129
+
130
+ ```bash
131
+ texplorer --doctor
132
+ ```
133
+
134
+ ## Clipboard
135
+
136
+ Backend dipilih otomatis:
137
+
138
+ | Environment | Backend |
139
+ |---|---|
140
+ | Termux | `termux-clipboard-set` |
141
+ | Linux Wayland | `wl-copy` |
142
+ | Linux X11 | `xclip` |
143
+ | Linux X11 alternatif | `xsel` |
144
+
145
+ Clipboard sistem bersifat opsional. Clipboard internal copy/cut/paste tetap berfungsi tanpa backend tersebut.
146
+
147
+ ## `bat` di Debian/Ubuntu
148
+
149
+ Pada sebagian versi Debian/Ubuntu executable paket `bat` bernama `batcat`.
150
+
151
+ Terminal Explorer mendeteksi keduanya otomatis:
152
+
153
+ ```text
154
+ bat
155
+ batcat
156
+ ```
157
+
158
+ Tidak perlu membuat symlink manual.
159
+
160
+ ## Install path
161
+
162
+ Termux:
163
+
164
+ ```text
165
+ $PREFIX/share/terminal-explorer/explorer.sh
166
+ $PREFIX/bin/terminal-explorer
167
+ $PREFIX/bin/texplorer
168
+ ```
169
+
170
+ Linux:
171
+
172
+ ```text
173
+ ~/.local/share/terminal-explorer/explorer.sh
174
+ ~/.local/bin/terminal-explorer
175
+ ~/.local/bin/texplorer
176
+ ```
177
+
178
+ Config:
179
+
180
+ ```text
181
+ ~/.config/terminal-explorer/
182
+ ```
183
+
184
+ Jika bookmark lama ditemukan di:
185
+
186
+ ```text
187
+ ~/.config/termux-explorer/bookmarks
188
+ ```
189
+
190
+ bookmark akan disalin otomatis saat config baru belum ada.
191
+
192
+
193
+ ## Release
194
+
195
+ Versi stabil saat ini:
196
+
197
+ ```text
198
+ v3.0.1
199
+ ```
200
+
201
+ Lihat [GitHub Releases](https://github.com/baska-pro/terminal-explorer/releases/latest) untuk source archive dan asset release.
202
+
203
+ ## Uninstall
204
+
205
+ ```bash
206
+ ./uninstall.sh
207
+ ```
208
+
209
+ Hapus juga config:
210
+
211
+ ```bash
212
+ ./uninstall.sh --purge
213
+ ```
214
+
215
+ ## Safety
216
+
217
+ Sebelum delete, rename overwrite, move overwrite, dan operasi destruktif lain, aplikasi meminta konfirmasi.
218
+
219
+ Path penting seperti `/`, `/etc`, `/usr`, `/var`, `$HOME`, dan root Termux dilindungi dari operasi delete melalui menu.
220
+
221
+ Baca [docs/SAFETY.md](docs/SAFETY.md).
222
+
223
+ ## License
224
+
225
+ BASKA-PRO PERSONAL USE LICENSE
226
+ Version 1.0
227
+
228
+ Copyright (c) 2026 Lathif Baska
229
+ All Rights Reserved.
baska_explorer-3.0.1/VERSION ADDED
@@ -0,0 +1 @@
1
+ 3.0.1