crunchbang/README.md
2025-03-28 17:39:07 +04:00

85 lines
1.9 KiB
Markdown

# Crunchbang
A collection of utility scripts for macOS system management and automation.
## Scripts
### `dock.sh`
Manages macOS Dock settings.
```bash
./scripts/dock.sh [check|reset]
```
- `check` - Show current Dock tile size
- `reset` - Reset Dock to default settings
### `movefiles.sh`
Moves files from one location to another based on a search word in the filename.
```bash
./scripts/movefiles.sh [options] <search_word> <source_directory> <destination_directory>
```
Options:
- `-v, --verbose` - Show detailed output
- `-p, --include-part` - Include files ending in .part (excluded by default)
- `-h, --help` - Show help message
Example:
```bash
./scripts/movefiles.sh -v "search-word" ~/Downloads ~/Documents
```
Features:
- Searches for files containing the specified word in their filename (case-insensitive)
- Excludes .part files and macOS resource fork files by default
- Creates destination directory if it doesn't exist
- Shows preview of files to be moved before proceeding
- Asks for confirmation before moving files
- Reports number of files moved after completion
### `toggle-metal-hud.sh`
Toggles the Metal HUD (Heads-Up Display) for macOS Metal applications.
```bash
./scripts/toggle-metal-hud.sh
```
Features:
- Toggles Metal HUD on/off with a single command
- Shows current status in the terminal
- Useful for debugging Metal applications and monitoring GPU performance
## Installation
1. Clone this repository:
```bash
git clone https://github.com/yourusername/crunchbang.git
cd crunchbang
```
2. Make the scripts executable:
```bash
chmod +x scripts/*.sh
```
## Usage
All scripts are located in the `scripts` directory. Each script has built-in help that can be accessed by running it without arguments.
Example:
```bash
./scripts/dock.sh
```
## Requirements
- macOS
- Bash or compatible shell
## License
MIT License - feel free to use and modify these scripts as needed.
## Contributing
Feel free to submit issues and enhancement requests!