Skip to content

Commit e8457fa

Browse files
committed
Add dot_clean tutorial
1 parent 6fe85d0 commit e8457fa

4 files changed

Lines changed: 38 additions & 2 deletions

File tree

docs/images/Apple_Logo.png

111 KB
Loading

docs/images/Computer_View.png

46 KB
Loading

docs/tutorials/dotclean.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
title: Clearing MacOS Dotfiles
3+
---
4+
5+
![Apple Logo](../images/Apple_Logo.png){ align=right width="60"}
6+
# Clearing MacOS Dotfiles
7+
8+
!!! info "What Are MacOS Dotfiles?"
9+
10+
MacOS creates `._` files for each file it copies into a FAT32 partition. This means that if you copy `GreatGame.nds` to your SD card, MacOS will also create a corresponding dotfile for it on your SD card next to the file: `._GreatGame.nds`.
11+
12+
These dotfiles are used for metadata, and MacOS will hide them when browsing files in Finder. However, this is a MacOS-specific behavior, and they will be displayed as normal files by any other device.
13+
14+
Flashcart kernels will mistake MacOS metadata files for regular ROM files, which can clutter up the cart's UI. Therefore, it's advised to remove them after using MacOS to manage your flashcart's SD.
15+
16+
### Removing Dotfiles With `dot_clean`
17+
18+
1. Insert the SD card into your Mac. It will mount under `/Volumes/`, named after the card's label. `/Volumes/PICO` is the example label we will be using in these steps.
19+
20+
2. Open Finder, then press ++cmd+shift+c++. This should take you to the "Computer" view in Finder where you can see all drives mounted on the system.
21+
22+
: ![MacOS Computer View](../images/Computer_View.png)
23+
24+
3. Open the Terminal app (press ++cmd+space++ to launch Spotlight Search, type `Terminal`, then press ++return++).
25+
26+
4. Type `dot_clean -m⠀` (with the trailing space) in Terminal, but do not press ++return++ yet.
27+
28+
5. Go back to the Finder window you opened earlier. Drag and drop your SD card from Finder into the Terminal window.
29+
30+
6. You should now have the SD path filled into Terminal. In our example with the `PICO` labeled SD, the terminal should show `dot_clean -m /Volumes/PICO`
31+
32+
7. Press ++return++ to run the command and remove dotfiles. If successful, the command will not show any output in the terminal, but will still apply the changes to your SD.

docs/tutorials/formatting.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -328,7 +328,7 @@ title: Formatting a microSD Card
328328

329329
</div>
330330

331-
1. ![Partition Table Settings](../images/KDE-PartMan-1.png){ width="400"}
331+
1. ![Partition Table Settings](../images/KDE-PartMan-1.png){ width="400"}
332332

333333
2. ![Filesystem Settings](../images/KDE_PartMan-2.png){ width="400"}
334334

@@ -432,4 +432,8 @@ title: Formatting a microSD Card
432432

433433
1. Click `OK`, then `Apply`, and then `Partition`.
434434

435-
1. Eject your SD card, and then you're done!
435+
1. Eject your SD card, and then you're done!
436+
437+
!!! tip "MacOS Dotfiles"
438+
439+
MacOS leaves behind metadata dotfiles when it writes files to FAT32 devices. After using MacOS to add files to your flashcart's SD (such as game ROMs or the kernel), it's a good idea to clear them so that they don't show up as duplicate files in your flashcart menu. See the [clearing MacOS dotfiles tutorial](./dotclean.md) for more info.

0 commit comments

Comments
 (0)