Repository navigation
DGF v1.0.1 Release Notes
π Patch Release β v1.0.1 (2025-08-15)
We are pleased to announce DGF v1.0.1, a patch release focused on improving installation, update, and uninstallation workflows, as well as enhanced token support and expanded platform builds.
π What's New & Improved
-
Installer Enhancements:
- The
dgf-installer.shscript now supports seamless updating of existing installations. It checks for the latest version and only updates if needed. - Added a robust uninstallation option (
--uninstall), allowing you to remove DGF from default or custom locations. - Improved error handling, debug output, and file verification (size and SHA256 checksum).
- More flexible installation for Windows, Linux, macOS, and Android (see builds below).
- The
-
Token Support:
- You can now provide a GitHub token via the
--tokenflag or theGITHUB_TOKENenvironment variable for private repositories. The CLI prioritizes the flag if both are set.
- You can now provide a GitHub token via the
-
Documentation:
- The README has been updated with detailed installation, update, uninstall, and argument usage instructions, including token handling and all command-line options.
π¦ New Builds Available
The following binaries are available for v1.0.1:
- dgf-1.0.1-linux-amd64
- dgf-1.0.1-linux-arm64
- dgf-1.0.1-linux-arm
- dgf-1.0.1-darwin-amd64
- dgf-1.0.1-darwin-arm64
- dgf-1.0.1-windows-amd64.exe
- dgf-1.0.1-windows-arm64.exe
- dgf-1.0.1-android-arm64
π Features Recap
- Download files or folders from GitHub, GitLab, and HuggingFace using a URL or detailed parameters.
- Filter downloads by file formats (e.g.,
[pdf,jpg,go]) or categories (image,video,code, etc.). - Check repository paths, print directory trees, and output repository info as JSON.
- Lightweight installation and easy updates via the installer script.
π Command-Line Options
| Option | Description |
|---|---|
--site, -s <site> |
Platform ID (github, gitlab, huggingface) |
--username, -u <username> |
Repository username |
--repo, -r <repo> |
Repository name |
--token, -t <token> |
GitHub token (or use GITHUB_TOKEN env) |
--branch, -b <branch> |
Branch name |
--commit, -c <commit> |
Commit ID |
--path, -p <path> |
Path in repository |
--output, -o <dir> |
Output directory (default: .) |
--format, -f <format> |
File formats to include (e.g., image, [jpg,pdf,png], or "" for no-extension files) |
--no-print, -n |
Suppress all output |
--print-tree |
Print directory tree |
--check |
Check if path exists |
--print-info, -i |
Print repository info as JSON |
--help, -h |
Show help message |
Only one of
--no-print,--print-tree,--check, or--print-infocan be provided at a time.
π Installation & Update
Download the installer:
curl -LO https://raw.githubusercontent.com/NeerajCodz/dgf/main/dgf-installer.sh
chmod +x dgf-installer.shInstall or update (system-wide, optional):
sudo ./dgf-installer.shUninstall:
sudo ./dgf-installer.sh --uninstall
# or from a specific directory
sudo ./dgf-installer.sh --uninstall /path/to/dirFor more options, see the installer help or README.
π¦ Examples
- Download all
.pdfand.jpgfiles:dgf -s github -u user -r repo -f [pdf,jpg]
- Download all images from a path:
dgf -s github -u user -r repo -p path/to/dir -f image
- Check if a path exists:
dgf -s github -u user -r repo -p path/to/file --check
- Download from a direct URL:
dgf https://github.com/user/repo/path/to/file.pdf
π€ Contributing
We welcome contributions! Please see the CONTRIBUTING.md for guidelines on reporting issues, suggesting features, and submitting code changes.
- Fork the repo, create a branch, make your changes, and open a pull request.
- Follow the code style and update documentation as needed.
π License
MIT License. See the LICENSE file for details.
Author: Neeraj SathishKumar