ShowHidden/README.md
manfromhuh 010e94259d Update to README.md
Added the key combination that this script is replaced by to the documentation.
2021-06-10 16:31:21 -04:00

70 lines
2.7 KiB
Markdown

# Show Hidden
Shows or hides hidden files in mac finder. In old versions of OSX this isn't a feature of Finder.
It's a very basic shell script.
Here's the full thing.
```bash
#show or hide hidden files in mac finder
show=$(defaults read com.apple.finder AppleShowAllFiles)
if [ "$show" == "TRUE" ]
then
defaults write com.apple.finder AppleShowAllFiles FALSE;killall Finder
else [ "$show" == "FALSE" ]
defaults write com.apple.finder AppleShowAllFiles TRUE;killall Finder
fi
exit
```
This script has been wrapped in a .dmg file for ease of use.
**[Note]:** *Only works on OSX.* It shouldn't damage anything if you run it on another system with bash installed but it won't do anything either.
## Requierments
A version of OSX around 10.6
OSX 10.6.8 is the only thing this has been tested on. If you have a simi-modern version of OSX/macOS this functionality is now built into Finder.
The key combination is `Command + Shift + .` or `⌘⇧.` in a more mac symbology.
## Running
Two methods of running are provided.
#### Method 1. The script
* Download the script or copy it from this [readme](https://efrick.ddns.net/git/manfromhuh/ShowHidden/src/branch/master/README.md) and place it in a folder on your path.
* Add execute permissions. Example `chmod u+x /path/to/script/show_hidden.sh`
* Run from the commandline.
#### Method 2. The app
* Download the [.dmg](https://efrick.ddns.net/git/manfromhuh/ShowHidden/releases).
* Open the .dmg and drag the application to the Applications folder.
* Run from the application menu
Or download the [.app](https://efrick.ddns.net/git/manfromhuh/ShowHidden/releases) and either manualy move to the Applications directory or run it from the
## The DMG
If you want to recreate the .app file.
1. Open Automator.
2. Select `Application` as the type.
3. Find and drag `Run Shell Script` to the sequence.
4. Copy and paste the contents of `show_hidden.sh` into the script window.
5. Name and save in `Application` format.
6. *[Optional]* To add a custom icon:
i. Obtain the image you want to use.
ii. Open in Preview.
iii. Save as `AutomatorApplet.icns` being sure to select `ICNS` format.
iv. Open the .app by right clicking and selecting `Show Package Contents`.
v. Go to the `Contents/Resources` directory and replace the existing `AutomatorApplet.icns` file with your custom one.
vi. Close the .app in Finder
If you want to recreate the .dmg file.
1. Follow the instructions [here](https://www.wikihow.com/Make-a-DMG-File-on-a-Mac) and add a symbolic link to the `Applications` folder.
2. Or use a tool such as [create-dmg](https://github.com/create-dmg/create-dmg). I can vouch for this tool working on OSX 10.6 as of version [1.0.8](https://github.com/create-dmg/create-dmg/releases/tag/v1.0.8).