![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/11\/Raspberry-Pi-Pico-Files-folders.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nLearning this subject is useful to create files to save configurations, save variables\u2019 values permanently (even after resetting the Raspberry Pi Pico), log data or sensor values in a file that you can use later, and much more.<\/p>\n\n\n\n
Prerequisites \u2013 MicroPython Firmware<\/h2>\n\n\n\n
To follow this tutorial, you need MicroPython firmware installed on your Raspberry Pi Pico board. You also need an IDE to write and upload the code to your board.<\/p>\n\n\n\n
The recommended MicroPython IDE for the Raspberry Pi Pico is Thonny IDE. Follow the next tutorial to learn how to install Thonny IDE, flash MicroPython firmware, and upload code to the board.<\/p>\n\n\n\n
- \n
- Programming Raspberry Pi Pico using MicroPython<\/a><\/li>\n<\/ul>\n\n\n\n
If you\u2019re still getting started with the Raspberry Pi Pico, follow one of these getting-started guides:<\/p>\n\n\n\n
- \n
- Getting Started with Raspberry Pi Pico 2 and Pico 2 W<\/a><\/li>\n\n\n\n
- Getting Started with Raspberry Pi Pico (and Pico W)<\/a><\/li>\n<\/ul>\n\n\n\n
Where to Buy Raspberry Pi Pico 2?<\/h4>\n\n\n\n
The Raspberry Pi Pico 2 W board is widely available on many different stores. Check the following link to compare its price on different stores:<\/p>\n\n\n\n
- \n
- Buy Raspberry Pi Pico 2 W<\/strong><\/a><\/li>\n<\/ul>\n\n\n\n
Subjects Covered in this Guide<\/h2>\n\n\n\n
In this guide, we\u2019ll take a look at basic file and directory operations using the os<\/span> MicroPython module:<\/p>\n\n\n\n
- \n
- File operations:<\/strong>\n
- \n
- Create\/open a file<\/li>\n\n\n\n
- Rename a file<\/li>\n\n\n\n
- Delete a file<\/li>\n\n\n\n
- Writing to a file<\/li>\n\n\n\n
- Appending to a file<\/li>\n\n\n\n
- Reading from a file<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- Directory operations:<\/strong>
- Create a new directory<\/li><\/ul>\n
- \n
- Listing files in a directory<\/li>\n\n\n\n
- Remove a directory<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
The os <\/em>MicroPython Module<\/h2>\n\n\n\n
In MicroPython, there\u2019s a module called os<\/span> that includes a wide range of functions to manage file operations. Additionally, it also comes with methods for tasks, like managing directories, accessing environment variables, and executing system commands. <\/p>\n\n\n\n
The os<\/span> module comes included by default on MicroPython firmware. More details about the os module can be found in the official documentation<\/a>.<\/p>\n\n\n\n
\n\n\n\nFile Operations<\/h2>\n\n\n\n
Open a new file in Thonny IDE. We\u2019ll show you some small snippets of code to illustrate how to perform file operations. Run the snippets as we show them to understand how everything works and see the returned results.<\/p>\n\n\n\n
Creating a File<\/h3>\n\n\n\n
Creating a file in MicroPython is as easy as using the open()<\/span> function and passing as argument the filename and the file opening mode. The open()<\/span> function will open the file if it already exists, or it will create a new file if it doesn\u2019t.<\/p>\n\n\n\n
The different modes for opening a file are ‘w’<\/span>, ‘r’<\/span>, and ‘a’<\/span>:<\/p>\n\n\n\n
- \n
- ‘w’<\/span>: writing mode \u2014 allows writing to a file, overwriting existing content;<\/li>\n\n\n\n
- ‘r’<\/span>: reading mode \u2014 enables reading from an existing file;<\/li>\n\n\n\n
- ‘a’<\/span>: appending mode \u2014 appending new data to the end of an existing file.<\/li>\n<\/ul>\n\n\n\n
To create a new file, we can use the writing mode (‘w’<\/span>). The following line of code will create a new file on the Raspberry Pi Pico filesystem using the open()<\/span> method. The file is called testFile.txt<\/span>, but you can rename it to whatever you want.<\/p>\n\n\n\n
file = open('testFile.txt', 'w')<\/code><\/pre>\n\n\n\nThe first argument of the open()<\/span> function is the file path. Because we\u2019re creating the files on the root directory of the Raspberry Pi Pico filesystem, we can simply pass the file name.<\/p>\n\n\n\n
Run this previous line on your Raspberry Pi by clicking on the Thonny green run icon.<\/p>\n\n\n
\n![\"RPi](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/11\/RPi-Pico-Create-File-Thonny-IDE.png?resize=634%2C206&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nA new empty file called testFile.txt<\/span> was created on the Raspberry Pi filesystem.<\/p>\n\n\n\n
To check if the file was created and saved, you can go to File<\/strong> > Save as\u2026<\/strong> > Raspberry Pi Pico<\/strong>. You can see all the files saved on the Pico filesystem, including the testFile.txt<\/span> we just created.<\/p>\n\n\n
\n![\"Test](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/11\/Test-File-saved-on-RPi-Pico-Filesystem.png?resize=545%2C327&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAnother way to check the files on the Raspberry Pi Pico filesystem in Thonny IDE is by going to View<\/strong> > Files<\/strong>.<\/p>\n\n\n\n
On the left sidebar, it will show you the files on your computer and the files on the Raspberry Pi Pico. You can click on the three-dash icon to refresh the filesystem.<\/p>\n\n\n
\n![\"File](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/11\/Files-saved-RPi-Filesystem-Sidebar-Thonny-IDE.png?resize=750%2C579&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThe testFile.txt<\/span> will be there, and you can double-click on it to open it.<\/p>\n\n\n\n
Listing Files in the Filesystem<\/h3>\n\n\n\n
Instead of having to do this procedure to check the content of the filesystem, we can use a function from the os<\/span> module that lists all files in the directory. For that, we need to import the os<\/span> module first.<\/p>\n\n\n\n
import os<\/code><\/pre>\n\n\n\nAnd then, we can use the following command to check the contents of the filesystem:<\/p>\n\n\n\n
os.listdir()<\/code><\/pre>\n\n\n\nTo test this, create a new file on Thonny IDE and copy the following two lines. We use the print()<\/span> function to print the results on the Shell.<\/p>\n\n\n\n
import os\nprint(os.listdir())<\/code><\/pre>\n\n\n\nRun this section of code. It should print the current contents of the filesystem into the Shell. Notice that it should list the file you created previously, the testFile.txt<\/span>.<\/p>\n\n\n
\n![\"RPi](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/11\/RPi-Pico-Thonny-IDE-list-files.png?resize=612%2C519&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nRenaming a File<\/h3>\n\n\n\n
To rename a file, you can use the rename()<\/span> method from the os<\/span> module. Pass as arguments the current name of the file and the new name for the file. For example:<\/p>\n\n\n\n
os.rename('old_file_name.txt', 'new_file_name.txt')<\/code><\/pre>\n\n\n\nTo change the name of our previous file, you can run the following example (it already checks the contents of the filesystem with os.listdir()<\/span>).<\/p>\n\n\n\n
import os\nos.rename('testFile.txt','newNameFile.txt')\nprint(os.listdir())<\/code><\/pre>\n\n\n\nRun these previous lines on your Raspberry Pi Pico. Notice that the name of the file was changed to newNameFile.txt<\/span>.<\/p>\n\n\n
\n![\"RPi](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/11\/RPi-Pico-Thonny-IDE-Rename-File.png?resize=634%2C519&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nWriting to a File<\/h3>\n\n\n\n
Writing to a file is very straightforward. You just need to use the write()<\/span> method on the file<\/span> object and pass as argument the data you want to write (it must be a string). <\/p>\n\n\n\n
First, you need to open the file in writing mode.<\/p>\n\n\n\n
file = open('newNameFile.txt', 'w')<\/code><\/pre>\n\n\n\nFor example, to write some data to the file:<\/p>\n\n\n\n
file.write(\"Writing my first line\")<\/code><\/pre>\n\n\n\nAfter writing to the file, you should call the close()<\/span> method to close the file and save its content.<\/p>\n\n\n\n
file.close()<\/code><\/pre>\n\n\n\nThe write()<\/span> method will overwrite any previous data on the file.<\/p>\n\n\n\n
Appending to a File<\/h3>\n\n\n\n
If you want to add new data at the end of an existing file, you must write to the file in appending ‘a’<\/span> mode.<\/p>\n\n\n\n
Open the file in appending mode:<\/p>\n\n\n\n
file = open('newNameFile.txt', 'a')<\/code><\/pre>\n\n\n\nWrite to the file using the write()<\/span> method:<\/p>\n\n\n\n
file.write('This line was appended')<\/code><\/pre>\n\n\n\nAfter writing to the file, you should call the close()<\/span> method to close the file and save its content.<\/p>\n\n\n\n
file.close()<\/code><\/pre>\n\n\n\nReading a File<\/h3>\n\n\n\n
To read a file, first you need to open it in reading ‘r’<\/span> mode. For example:<\/p>\n\n\n\n
file = open('newNameFile.txt', 'r')<\/code><\/pre>\n\n\n\nThen, we can read its content using the read()<\/span> method on the file<\/span> object. For example:<\/p>\n\n\n\n
file.read()<\/code><\/pre>\n\n\n\nWe can save the content of the file in a variable, and then print it on the Shell:<\/p>\n\n\n\n
content = file.read()\nprint(\"File content:\")\nprint(content)<\/code><\/pre>\n\n\n\nDon\u2019t forget, to always close the file after performing file operations:<\/p>\n\n\n\n
file.close()<\/code><\/pre>\n\n\n\nThe following code performs all the file operations we\u2019ve seen previously:<\/p>\n\n\n
# Rui Santos & Sara Santos - Random Nerd Tutorials\n# Complete project details at https:\/\/RandomNerdTutorials.com\/raspberry-pi-pico-files-directories-micropython\/\n\nimport os\n\n# Create a new file called testFile.txt\nfile = open('testFile.txt', 'w')\n\n# List all files in the filesystem\nprint(os.listdir())\n\n# Write content to the file\nfile.write("Writing my first line \\n")\nfile.close()\n\n# Rename the file\nos.rename('testFile.txt','newNameFile.txt')\n\n# List all files in the filesystem\nprint(os.listdir())\n\n# Open the file in appending mode\nfile = open('newNameFile.txt', 'a')\n# Append data to the file\nfile.write('This line was appended')\nfile.close()\n\n# Open file in reading mode\nfile = open('newNameFile.txt', 'r')\n\n# Read the content of the file\ncontent = file.read()\n\n# Print the content of the file\nprint("File content:")\nprint(content)\nfile.close()\n<\/code><\/pre>\n\tView raw code<\/a><\/p>\n\n\n\n
If you run this previous code on your Raspberry Pi Pico, you should get something similar as shown in the screenshot below.<\/p>\n\n\n
\n![\"RPi](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/11\/RPi-Pico-Thonny-IDE-File-Operations.png?resize=637%2C239&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThe Newline Character<\/h4>\n\n\n\n
In the previous code, notice that we use a \\n<\/strong> at the end of this line:<\/p>\n\n\n\n
file.write(\"Writing my first line \\n<\/strong>\")<\/code><\/pre>\n\n\n\nIn Python\/MicroPython, the \\n<\/span> represents a newline character. It is used to represent the end of a line in a text file. It is a control character that signifies the beginning of a new line of text. <\/p>\n\n\n\n
When working with files, the newline character is useful for formatting text. When writing multiple lines to a file, you use \\n<\/span> to separate each line.<\/p>\n\n\n\n
Deleting a File<\/h3>\n\n\n\n
To delete a file, you can use os.remove()<\/span> and pass as argument the file path. For example, to remove the newNameFile.txt<\/span>, you can simply run the following:<\/p>\n\n\n\n
import os\nos.remove('newNameFile.txt')<\/code><\/pre>\n\n\n\nTo check if the file was actually removed, you can list all files in the directory, after the previous commands.<\/p>\n\n\n\n
# List all files in the filesystem\nprint(os.listdir())<\/code><\/pre>\n\n\n\nAfter running these previous lines, you can see that the newNameFile.txt<\/span> is not on the filesystem anymore.<\/p>\n\n\n\n
The \u2018with\u2019<\/em> Keyword for File Operations<\/h3>\n\n\n\n
The with<\/strong><\/span> keyword is used with file operations to ensure proper resource management and simplify code. Specifically, it’s often used with the open()<\/span> function when dealing with files. For example:<\/p>\n\n\n\n
with open('file_path', 'w') as file:\n file.write('hello world!')<\/code><\/pre>\n\n\n\nThis syntax automatically handles opening and closing the file, ensuring that the file is properly closed when you’re done with it, even if an exception occurs during file operations.<\/p>\n\n\n\n
The previous snippet is equivalent to the following:<\/p>\n\n\n\n
file = open('file_path', 'w')\ntry:\n file.write('hello world!')\nfinally:\n file.close()<\/code><\/pre>\n\n\n\nSo, using the with<\/span> keyword simplifies your code and ensures proper file management.<\/p>\n\n\n\n
\n\n\n\nDirectory Operations<\/h2>\n\n\n\n
The os<\/span> module also comes with useful methods to work with directories (folders). Working with directories is very useful for organizing files. Especially if you\u2019re working with multiple files.<\/p>\n\n\n\n
Creating a Directory<\/h3>\n\n\n\n
Creating a new directory is as easy as using the mkdir()<\/span> method from the os<\/span> module. You should pass as argument the directory path. If you want to create the folder at the root of the Raspberry Pi Pico filesystem, you can just pass the directory name.<\/p>\n\n\n\n
For example, the following code creates a new directory called my_directory<\/em><\/span> at the root of the Raspberry Pi Pico filesystem:<\/p>\n\n\n\n
import os\n\n# Specify the directory path\ndir_path = 'my_directory'\n# Create a new directory\nos.mkdir(dir_path)<\/code><\/pre>\n\n\n\nRun this previous code to create the folder on the Pico filesystem.<\/p>\n\n\n\n
You can check that new directory shows up on the list of files on the filesystem.<\/p>\n\n\n
\n![\"RPi](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/11\/RPi-Pico-Thonny-IDE-Create-New-Directory.png?resize=718%2C547&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nListing Files in a Directory<\/h3>\n\n\n\n
As we\u2019ve seen previously, you can use the listdir()<\/span> method to list all files in the filesystem. If you want to list the files inside a particular folder, you just need to pass the folder path as an argument. For example, the following code will check the content of your new directory my_directory<\/em><\/span>:<\/p>\n\n\n\n
import os\n\ndir_path = 'my_directory'\n\n# List the files in the directory\nfiles = os.listdir(dir_path)\nprint(\"Files in the directory:\", files)<\/code><\/pre>\n\n\n\nRun this previous code. In this case, it will return an empty array, because the directory is empty.<\/p>\n\n\n
\n![\"RPi](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2025\/11\/RPi-Pico-CheckFiles-in-Directory-Thonny-IDE.jpg?resize=624%2C250&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nDeleting a Directory<\/h3>\n\n\n\n
The os<\/span> module comes with a method to delete empty folders. You can use the rmdir()<\/span> method and pass as argument the directory path. For example:<\/p>\n\n\n\n
import os\ndirectory_path = 'my_directory'\nos.rmdir(directory_path)<\/code><\/pre>\n\n\n\nIf you want to delete a directory, first you need to delete its files before applying the rmdir()<\/span> method.<\/p>\n\n\n\n
Wrapping Up<\/h2>\n\n\n\n
In this tutorial, we covered how to handle files and folders on the Raspberry Pi Pico filesystem. You learned how to create, write, read, and delete files, and create, delete, and list directories.<\/p>\n\n\n\n
If you want to learn how to do something similar, but using a microSD card, you can check out the following tutorial:<\/p>\n\n\n\n
- \n
- Raspberry Pi Pico: MicroSD Card Guide with Datalogging Example (MicroPython)<\/a><\/li>\n<\/ul>\n\n\n\n
We hope this guide was useful.<\/p>\n\n\n\n
Learn more about programming the Raspberry Pi Pico using MicroPython using our eBook:<\/p>\n\n\n\n
- ‘r’<\/span>: reading mode \u2014 enables reading from an existing file;<\/li>\n\n\n\n
- ‘w’<\/span>: writing mode \u2014 allows writing to a file, overwriting existing content;<\/li>\n\n\n\n
- Create a new directory<\/li><\/ul>\n
- File operations:<\/strong>\n
- Getting Started with Raspberry Pi Pico (and Pico W)<\/a><\/li>\n<\/ul>\n\n\n\n
- Getting Started with Raspberry Pi Pico 2 and Pico 2 W<\/a><\/li>\n\n\n\n