https://github.com/willwade/crickextract
extracts media from clicker docs
https://github.com/willwade/crickextract
Last synced: 4 months ago
JSON representation
extracts media from clicker docs
- Host: GitHub
- URL: https://github.com/willwade/crickextract
- Owner: willwade
- License: mit
- Created: 2024-12-25T01:17:19.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-25T23:55:51.000Z (over 1 year ago)
- Last Synced: 2025-05-24T00:11:31.817Z (about 1 year ago)
- Language: Python
- Size: 29.3 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Extract Clicker Media
A standalone script to extract embedded media (images, sounds, etc.) from `.clkx` (Clicker Grids) files. This tool decodes base64-encoded media and saves them as standalone files.
## Requirements
- A `.clkx` file to process.
- Supported operating systems:
- **Windows** for the `.exe` version.
- **macOS** for the macOS binary version.
## Downloading the Script
1. Go to the **Releases** section of this repository on GitHub.
2. Download the appropriate version for your operating system:
- **Windows**: `extract_clicker_media-windows-latest.exe`
- **macOS**: `extract_clicker_media-macos-latest`
3. Save the downloaded file to a convenient location.
## Using the Script
### For Windows Users:
1. Save the `.clkx` file in the same directory as the downloaded script or note its full path.
2. Open a Command Prompt:
- Press `Win + R`, type `cmd`, and press Enter.
3. Navigate to the directory where the script is saved:
```cmd
cd path\to\directory
4. Run the script with the path to the `.clkx` file as an argument:
```cmd
extract_clicker_media-windows-latest.exe path\to\file.clkx
```
or
```cmd
extract_clicker_media-windows-latest.exe path\tp\files\*.clkx
```
i.e. either a single file or multiple files can be extracted at once.
5. The extracted files will be saved in a new folder, named _extracted, in the same directory as the .clkx file.
### For macOS Users:
1. Save the `.clkx` file in the same directory as the downloaded script or note its full path.
2. Open a Terminal:
- Press `Cmd + Space`, type `Terminal`, and press Enter.
3. Navigate to the directory where the script is saved:
```bash
cd path/to/directory
```
4. Run the script with the path to the `.clkx` file as an argument:
```bash
./extract_clicker_media-macos-latest path/to/file.clkx
```
5. The extracted files will be saved in a new folder, named _extracted, in the same directory as the .clkx file.
## Notes
- The script will create a new folder in the same directory as the `.clkx` file to store the extracted media.
- The extracted media files will retain their original file names.
- The script will overwrite any existing files with the same name in the extraction folder.
- The script does not modify the original `.clkx` file.
## License
MIT License
## Author
Will Wade @ gmail . com