User Manual
First find the volume name for your board. With the board plugged in run this command in a terminal to list all the
volumes:
Look for a volume with a name like CIRCUITPY (the default for CircuitPython). The full path to the volume is
the /Volumes/CIRCUITPY path.
Now follow the steps from this question (https://adafru.it/u1c) to run these terminal commands that stop hidden files
from being created on the board:
Replace /Volumes/CIRCUITPY in the commands above with the full path to your board's volume if it's different. At this
point all the hidden files should be cleared from the board and some hidden files will be prevented from being created.
However there are still some cases where hidden files will be created by Mac OSX. In particular if you copy a file that
was downloaded from the internet it will have special metadata that Mac OSX stores as a hidden file. Luckily you can
run a copy command from the terminal to copy files without this hidden metadata file. See the steps below.
Copy Files on Mac OSX Without Creating Hidden Files
Once you've disabled and removed hidden files with the above commands on Mac OSX you need to be careful to
copy files to the board with a special command that prevents future hidden files from being created. Unfortunately
you cannot use drag and drop copy in Finder because it will still create these hidden extended attribute files in some
cases (for files downloaded from the internet, like Adafruit's modules).
To copy a file or folder use the -X option for the cp command in a terminal. For example to copy a foo.mpy file to the
board use a command like:
(Replace foo.mpy with the name of the file you want to copy.) Or to copy a folder and all of its child files/folders use a
command like:
If you are copying to the lib folder, or another folder, make sure it exists before copying.
ls -l /Volumes
mdutil -i off /Volumes/CIRCUITPY
cd /Volumes/CIRCUITPY
rm -rf .{,_.}{fseventsd,Spotlight-V*,Trashes}
mkdir .fseventsd
touch .fseventsd/no_log .metadata_never_index .Trashes
cd -
cp -X foo.mpy /Volumes/CIRCUITPY
cp -rX folder_to_copy /Volumes/CIRCUITPY
© Adafruit Industries https://learn.adafruit.com/adafruit-metro-m4-express-featuring-atsamd51 Page 105 of 172










