File Exchange

image thumbnail

uipickfiles: uigetfile on steroids

version 1.13 (12.1 KB) by

Many-featured, platform independent file and directory picker.

67 Ratings



View License

Editor's Note: This file was selected as MATLAB Central Pick of the Week

This is a GUI application that allows multiple files or directories to be selected and allows you to manage the list (remove files, reorder, etc.) before returning. It has basic filtering as well as regular expression filtering and navigation of the file system is easy. The output is configurable (cell, struct or char arrays). It is written entirely in M and so is platform independent.

Comments and Ratings (119)


kes22 (view profile)


One of the best! A very neat work!


Yishai (view profile)

Very useful tool! Excellent execution and functionality, kudos!

One little thing - It took me a while to find the feature that lets you open a list of recent folders to flash-nav to. I think it would be more intuitive to have that as a drop-down box from the current folder box or something of that sort. Maybe this is not straightforward using matlab's GUIDE.

At any rate, a much needed resource, thanks!


fast, accurate, and reliable. the best of its kind

Douglas Schwarz

Katharina, please check that you have made this change to the copy of the m-file on your PC:

Change the line (on or near line 186)

dir_picks = dir(' '); % Create empty directory structure.

to be

dir_picks = repmat(dir(char(127)),0,1); % Create empty directory structure.

If that doesn't fix the problem, email me and I will investigate further.


Hi Doug, thanks for this fantastic tool! I use it all the time. Just wanted to mention that the problem which occurs on MATLAB 2015a & b is not fixed for me. If struct is used as output I get the folders I selected + the names of all other folders in that directory. (This does not happen if cell is selected as output and also does not happen on my Mac. ).

Fantastic! Exactly what I needed for a multiple folder selection tool, so helpful.

E. Cheynet

This is probably one of the File Exchange submission I like most :)

Douglas Schwarz

Lex, you can access folder on a server, but you have to type in the server name, e.g., "\\server\folder". It's true that it doesn't provide a list of possible servers on the local network.


Lex (view profile)

Works like a dream except it can only access folders on my computer. If you want to find a file on a folder on a server, it is unable to direct you to the network.

I am using Matlab 2013


Noel (view profile)

Vadim Frolov

Douglas Schwarz


1. This function is designed to work across platforms and is not exclusively a Windows function.

2. You can do what you want using the regular expression filter. Simply type '\.csv$|\.txt$' in the Regular Expression Filter box. This exact application is given as an example in the documentation.


Reto Zingg

Hi Ravi, very nice function. A handy addition would be to allow multiple filters in the 'Type' parameter. Standard Windows behavior is that I can for example type '*.csv;*.txt' and all files with these two endings will be shown. It appears uipickfiles only allows one single extension per type...

Douglas Schwarz

Ravi, I actually worked on that a while ago, but got busy with other things and didn't quite get it working. I will try to get back to it this week.

Ravi Goyal

Doug, great function! I only struggle as the function does not recognize File Shortcuts (.ink) so I cant access certain data, or only if I try to find the path and copy it by hand. Any idea how to fix that problem so shortcuts will work?

William Thielicke

Hi, my FEX contribution (PIVlab) heavily relies on uipickfiles for data import. Someone also just reported that strange things happen in uipickfiles in r2015a, and I am very glad to see that Douglas seems to have found a solution already...! I'll check it out now.

Douglas Schwarz

Dan, thanks, but I just finished installing R2015a and checked it out. They changed the behavior of dir again (slightly). You can fix the problem just by changing one line. Change the line (on or near line 186)

dir_picks = dir(' '); % Create empty directory structure.

to be

dir_picks = repmat(dir(char(127)),0,1); % Create empty directory structure.

and that will work forever (I hope!).

Dan K

Dan K (view profile)

Doug. Quick update.. It is only when the output is set to struct that this bug happens. I made a quick workaround by changing the code around line 611:

% Compute desired output.
switch prop.output
case 'cell'
out = full_file_picks;
case 'struct'
    out = cell2struct(full_file_picks,'name',1);
  for ientry = 1:numel(out)
    tmp = dir(out(ientry).name);
    out(ientry).date =;
    out(ientry).bytes = tmp.bytes;
    out(ientry).isdir = tmp.isdir;
    out(ientry).datenum = tmp.datenum;
  % out = dir_picks(:);
case 'char'
out = char(full_file_picks);
case 'cancel'
out = 0;

Douglas Schwarz

Dan, thanks for letting me know. I don't have R2015a yet, but as soon as I get it I'll check this out and fix whatever went wrong. - Doug

Dan K

Dan K (view profile)

It seems to me that R2015a has broken uipickfiles. It appears to always return all the files in a directory. Can anybody verify this?

Hi Mr. Anderson,

This is an excellent tool.
Can you please tell that how could I rename the file inside any folder with that folder name.
And how could I create a new folder and add my renamed files in it.
And display my files as a list.

I want the above mentioned functions in addition to this tool.Please give me some hints to add these features.


This is a fantastic utility. I'm a bit confused about 'FilterSpec', 'REFilter', and 'Type'. If you want to have results of two filters displayed at the same time, such as all '*.xls' and '*.xlsx' files, is the only way to do that through the REFilter? Thanks for a great function.

Douglas Schwarz

Dan K,
A favorites list is a great idea and I'm working on it. Also, you're right that the recent list fills up fast with intermediate folders so I've decided to put only destination folders in that list; I think that would be more useful. Thanks for the suggestions!

Molly Rossow

Dan K

Dan K (view profile)

This is a fabulous tool. One "feature request" I would love to see is a favorites list. The recent list is great, but since it tracks every folder visited, it can fill up fast with the intermediate folders needed to navigate to your new destination. Given that I frequently need to shift between widely separated directories on network shares and local drives, having a favorites that I could just use to hop to at least the approximate location would be great!



Adam (view profile)

Great improvements over the Matlab function!


Daniel (view profile)

Never mind! I'm an idiot, figured out what I was doing wrong

Ryan Edwards

Douglas Schwarz


Sorry for the delay -- somehow I missed your question.

Yes, you can show only folders by entering '^' as the regular expression filter. That will cause the program to display only files that begin with nothing. Since no file has no name and folders are exempt from RE filtering (by default), only folders will be displayed.


I realize that's a bit of a hack so I will consider adding such a feature.


This is a great replacement for the honestly awful built-in file box.

To hide hidden files ("dot files"):
uipickfiles('REFilter', '^[^\.]', 'REDirs', true)


John (view profile)


John (view profile)

Hi Doug!

This is a great tool!

Is there some way that I could have the function only show folders (i.e. similar to uigetdir)?

Rody Oldenhuis

Rody Oldenhuis (view profile)


Shmuel (view profile)

Douglas Schwarz

Philip, there is currently no way to invert the meaning of the filter to exclude items, but it could be done with a checkbox to indicate it. Let me see if I can fit it in somewhere.

For now, it seems like you could just filter on "new".

andres ferrer

Philip Pavey

Philip Pavey

Instead of filtering for a certain string contained within a folder title, is it possible to omit folders with this string from the list?

For example, I have a folder with 10 folders where 7 contain information I do not want and the string "old" in the title. I would like to show only the 3 folders containing "new" in the folder title.

Is there a way to construct the filter criteria to achieve this?


So useful. Thank you

Douglas Schwarz

Jesse, thanks for the very good suggestion.

Jesse Hopkins

Jesse Hopkins (view profile)

Thanks for this useful tool! One quick note, around line 205 you use exist(..,'file') and exist(..,'dir'). I've found these to be problematic, as exist will return true if it finds the input anywhere on the matlab path.

This actually did cause an error in my case, when I passed in a directory called "Workspace". The directory had been deleted, however exist('Workspace','file') returns true due to workspace.m in the matlab install directory. The subsequent call do dir returned an empty matrix, causing an assignment error.

I've found the following functions more reliable for performing isdir/isfile type operations:
function x = myisdir(str)
x = false;
    tmp = dir(str);
    if length(tmp) > 1 % if str is a dir, then tmp will always contain at least '.' and '..'
        x = true;

function x = isfile(str)
x = false;
tmp = dir(str);

if ~isempty(tmp) && length(tmp) == 1
if ~tmp.isdir
x = true;


Lily (view profile)


jvc (view profile)

A great tool! I use this all the time and just finally got around to rating it. Thanks for sharing this.

Great file!
A great addition would be to make it so that it could also pick files remotely using FTP.

Douglas Schwarz

iman, this question belongs on the newsgroup, but I will answer anyway.

Your error is that n is not an image, but just a string containing the image file name. You must load the image first:

[filename,folder] = uigetfile(...);
im = imread(fullfile(folder,filename));


iman (view profile)

I use uigetfile to upload image from file in matlab GUI. I don't got any problem with this but when i try to save the image i got error, plez can someone help me.

this is my code

n=uigetfile({'*.jpg;*.tif;*.png;*.gif','All Image Files';... '*.*','All Files' },'Testing',...'C:\Users\norfadhilah\Application Data\Desktop\Testing');

imwrite (n,'myimage.jpg')

Doug and Andrew,

An idea: If displaying information on date and size was very important, perhaps you could use a colormap to shade the background of each file according to its size and/or date, and then only a scale (log scale for size?) would have to be included in the figure window.


Andrew (view profile)

Thanks. As long as the sorting works then I'm happy with it. It just wasn't clear that was happening since the values weren't displayed.

Douglas Schwarz


No, they aren't supposed to be displayed. I realize that it's not ideal, but there are two problems with displaying them. (1) There's not enough room. Remember, we have to display both the list of files on the left and the chosen files on the right. To display additional information would simply make the figure too wide. (2) It would be difficult (maybe impossible) to get multiple columns to line up without using a monospaced font. A monospaced font would take up even more room and just exacerbate problem 1.

Those are my reasons, but I will think about your request and if I can come up with a way to do it without sacrificing appearance or functionality I'm not opposed.



Andrew (view profile)

Thanks for the quick updates. One other request or possible bug fix, in the window it gives options to sort by Date and Size, but date and size aren't displayed for any of the files. Are they supposed to be? I'm running it in Matlab 2012a on a Macintosh. Thx.

Douglas Schwarz

Chris, I uploaded a new version that deals with the "My Documents" issue.

Douglas Schwarz


I hadn't noticed this before, but I see what you mean. I think I know a way to check if the directory is real or a figment of Window's imagination (like "My Documents" is) so I should be able to drop "My Documents" from the list automatically. Note that "Documents" also appears so if you just select that all is well, but I agree that if "My Documents" doesn't represent a valid choice it shouldn't appear at all. I will work on it and update uipickfiles soon. Thanks for the report.


Chris (view profile)

Hey Doug,

I am using this function with Windows 7. When you navigate to your 'My Documents' folder, nothing is displayed because the actual folder name in the directory path is 'Documents'. If I edit the 'My ' out of the path displayed then the directory contents appear. Is there a place in the code where i could search the new directory path for 'My Documents' in order to replace it with 'Documents'? Other directories such as 'My Received Files' do don't exhibit the same error.

Douglas Schwarz

Bryan, that's interesting. Back when I first wrote this function, that was not an error, but at some point TMW changed textscan and I didn't notice. Anyway, I just submitted a fix. Thanks for the report!


Bryan (view profile)

Douglas, great function. I noticed a bug while using on a PC. When I back out all the way to My Computer and open a new drive. I get an error at line 1299 for calling textscan with the first input empty.

Douglas Schwarz

Andrew, I'm glad to oblige. I just submitted a version that cancels with a press of the escape key. Thanks for the suggestion.


Andrew (view profile)

Love the program. Only thing I'd like is if you press escape on the keyboard it be the equivalent of clicking the cancel button (it's the only thing uigetfile has up on this one). Thanks.

Douglas Schwarz

I just uploaded a new version that is resizable and remembers the size and position so you can choose any size you want.

Lube F

Lube F (view profile)

Excellent function. One (stupid) question: I've got long file names and would like the gui window to open maximized so that I can see them fully. Is this possible? Could be incorporated if necessary?


Thanks a lot ! Very time saving for me

Douglas Schwarz

Horia, you must have another file called uipickfiles.m because that line of code simply does not exist in my function. Run 'which uipickfiles -all' to help sort this out.


Horia (view profile)

I re-downloaded the file.
When executing the function, I get:

??? Error using ==> setappdata
Invalid object handle

Error in ==> uipickfiles at 382
setappdata(hgui, 'sequencer', 1); %default style

Sorry, but I can't figure why this happens.

Douglas Schwarz

Horia, try downloading it again because I just downloaded it myself to be sure and setappdata is not in there. The downloaded uipickfiles.m is exactly as it should be.


Horia (view profile)

It appears in the downloaded file.

Douglas Schwarz

Horia, I don't know what function you have because I don't use setappdata in my function at all.


Horia (view profile)

On R2008a,I get the message:
??? Error using ==> setappdata
Invalid object handle

Error in ==> uipickfiles at 382
setappdata(hgui, 'sequencer', 1); %default style


That's an excellent tool. All it's really missing is cut/copy/paste functionality. Sounds feasible too.

Douglas Schwarz

Md. Niazul,

Try replacing the calls to sort in lines 1025-1037 with sort_nat. It might do what you want. It is available from


Md. Niazul

I am using this function uipickfiles. But my problem is, GUI of this function does not show the file names in the same order ,as they are in the folder.
In the folder my files look like:


but the GUI of this function is showing like this:

how can i fix the problem ..Could anyone help please.??

Zhijiang Wang

Good Job! Good man!


sjye (view profile)

Douglas Schwarz

Hi Asaad,

Are you using my function, uipickfiles, or the built-in function uigetfile? If mine, please let me know what arguments you are using.


Asaad Said

Hi Douglas,

I'm having a problem reading many files (>780 files) using uigetfile function. the function works fine if I read less than 780 files. I'm getting the following error message
"File not found. Please verify the correct file name was given"

I looked at this error online, but didn't find any solution online on Mathworks website.
I appreciate if you can help or provide a link for this issue


This is something TMW should have made a long time ago.

Thank you for sharing it, it works very well.


That was exactly what I was looking for. Thank You!


Igor (view profile)

Very good...


James (view profile)


Eric (view profile)

Thanks very much. This is a great tool that I've incorporated into my GUIs when I need to select a large number of files.


gozer (view profile)

I should mention one other thing. The directories and files I am accessing are on a network drive...not sure if that makes a difference. (the network drive is specified in the filter property value)

Douglas Schwarz

gozer, I'm not sure what you mean. You should be able to navigate around the file system and add files to the Selected Files list from multiple directories. When you say 'pick list', which one do you mean, the list on the left or the one on the right? The one on the left should show the contents of one directory at a time while the list on the right should show every file you have added to it until you press 'Done'. Please clarify. - Doug


gozer (view profile)

Would like to add my kudos to your work. excellent job....with one question;
I have a need to be able to select files for various directories. But it seems once a select files from one directory, then try to level-up to another it does not refresh the 'pick list'. Am I doing something wrong?

Hey cool, thank you very much!!

Douglas Schwarz

I just fixed it and uploaded the new version -- it should appear soon. Thanks for the bug report!

Very nice, I especially like the possibility to sort the filenames manually in the GUI. But when I set 'output' to 'struct' (that is what I need for my application), it doesn't care anymore about manual sorting. Is there a way to fix this problem?

Great! No Guide, does the job, very useful.

Very useful


Weimin (view profile)


Bernd (view profile)

This would have saved me a lot of programming, well it will even save some time in future....perfekt, classic 5 stars for SUPERUSEFUL

Nathan Greco

Very useful, especially when loading in multiple files at one with a regexp filter. Thanks a lot!

Douglas Schwarz

J W, what platform are you using and what kinds of files are those? Do the hidden files somehow pair up with non-hidden versions so you have both ._abc.txt and abc.txt? It would be easy to add a feature so that hidden files are not displayed in uipickfiles as long as we can identify them. Tell me more.


J W (view profile)

Actually, I just found a workaround. At every designation of 'filenames' I follow it with a series of loops testing each filename to see if it is preceded by '._' My supplement to the code is working well if anyone needs to have hidden files removed from file lists.


J W (view profile)

Great File! One quick question though - how might I go about removing hidden files from file lists? I notice that when I have hidden files in the same directory as the images I am trying to retrieve, hidden file versions with prefix '._' appear first making file selection very non-intuitive. Any solutions?

Douglas Schwarz

Skip, you can double-click on a file and it will be added to the list immediately. That may be sufficient for your purposes, but I will look into your suggestion.


Skip (view profile)

Very useful. Thank you!

Is it possible to have files added to the list in Ctrl+click order? This would avoid the need to sort files after selecting.

Rene Michels

Great Job,

THX for sharing! It really helps me out!!

Ben Bratton

Excellent code. Very helpful for myself and colleagues. We work with image processing and this greatly simplifies our lives.

Thomas Ibbotson

This looks like just what I need. However I was getting an error when I first tried to use it. It appears that if you specify a filter which returns no files, there is an error:

??? Error using ==> vertcat
CAT arguments are not consistent in structure field number.

Error in ==> uipickfiles>filtered_dir at 762
d = [ddot1;ddot2;dfiles(index1);ddir(index2)];

Error in ==> uipickfiles at 164
fdir = filtered_dir(full_filter,re_filter);

I fixed this by adding these lines:

762 if ~isempty(dfiles)
763 d = [ddot1;ddot2;dfiles(index1);ddir(index2)];
764 else
765 d = [ddot1;ddot2;ddir(index2)];
766 end

It might not be the best way to do it, but it works for me.

Joe Spernyak

Great for Queue'ing up lots of files/datasets for overnite processing.

Jeff Meganck

Incredibly useful, very well written program. I have incorporated this program into almost all of my own scripts. I just upgraded to R2007b(7.5.0) and started to get the following problem:

??? Subscripted assignment between dissimilar structures.

Error in ==> uipickfiles>add at 353
dir_picks(end + 1) = dir_pick;

??? Error using ==> waitfor
Error while evaluating uicontrol Callback

The fix was easy. Add 'datenum',[] at the end of line 171 so that it reads:
dir_picks = struct('name',{},'date','','bytes',[],'isdir',[],'datenum',[]);

B. Andre Weisntock

I needed an intuitive way for a non-MatLab user to load multiple directories into a MatLab stand-alone application and this product was EXACTLY what was needed. Perfect. Many thanks Doug!

Oleksandr (Alex) Dzyubak

I am working on image processing and for me that is usual practice to have more than 100 images in a set. The native MATLAB utility uigetfile does not support that at the moment.
In fact, uipickfiles DOES. Which is more, it works in Linux and Windows and for R2006b and R2007a. Thanks Douglas!!! Nice product!


Elakkat D

reallay useful tool

Douglas Schwarz

Patrick, yes it could be done. Email me and we'll discuss it. -- Doug

Patrick Naulleau

Any chance of getting a non-nested function version of this allowing it to work in earlier versions of Matlab?

Chris K

Thank you for updating it! I am thrilled to be able use it!

Douglas Schwarz

TMW changed the struct returned by dir in R2007a. I have updated uipickfiles accordingly. (It will still work with older versions of MATLAB.) Thanks for the report.

Chris K

The interface looks great, but I can't use it because of the following error and others.

??? Subscripted assignment between dissimilar structures.

Error in ==> uipickfiles>add at 353
dir_picks(end + 1) = dir_pick;

??? Error using ==> waitfor
Error while evaluating uicontrol Callback

I am running:
MATLAB Version (R2007a) on Mac OS X

Oleksnadr Dzyubak

Just Great!!!
I work on Linux where uigetfile is buggy.
The "uipickfiles" is an excellent workarround.
Many thanks!

Johann Boleininger

Very useful, many thanks.

Lennaert Klerk

Great!! This saved me so much time and is going to be used a lot by me and my colleagues....

Laszlo Totthfalusi

Smashing, cool

Scott Miller

Sweet. This saves me a lot of time; I was going to have to write one of these myself. I like that it is written completely in m script; there is really no point in writting such an interface as a dll if you don't have to, and this makes is easy to customize. It also doesn't seem to to have that "where's my dialog box?" effect of uigetfiles, (NOT uigetfile!), where occasionally, randomly, the dialog box will "open" with the window closed on startup. My only complaint as a windows user is uipickfiles has that funny UNIX smell to the UI (e.g., "..\" instead of an up arrow, files are sorted by case and then alphabetically instead of alphabetically), but hey, you can't have everything, and the script is right there if you want to change something.



Addressed problem mentioned by Chris. Now, on Windows, an attempt to open "My Documents" will be silently converted to an open of "Documents" instead if "My Documents" doesn't really exist.


Fixed bug identified by Bryan.


Added use of escape key as equivalent to Cancel button.


GUI is now resizable and remembers the size and position last used.


Added ability to sort file list by name, date or size.


Fixed bug in yesterday's version in recalling folders.


Added ability to recall previous selections. Fixed a few minor bugs.


Recent Folders list (right-click path box) is now sorted in chronological order and is persistent between calls (via a preferences setting). Also, ctrl-F will select all files (leaving folders unselected).


Minor interface changes -- backspace will go up one directory, control-A (command-A on the Mac) will select all as before, but won't cause menu bar to appear.


(Windows only) Now works correctly with UNC-named resources (e.g., \\machine\share).


Updated the user interface, appearance, documentation and internal comments.


Fixed bug identified by W Thielicke.

MATLAB Release
MATLAB 7.8 (R2009a)

Download apps, toolboxes, and other File Exchange content using Add-On Explorer in MATLAB.

» Watch video