Selenium give file name when downloading


I am working with a selenium script where I am trying to download a Excel file and give it a specific name. This is my code:

Is there anyway that I can give the file being downloaded a specific name ?


from selenium import webdriver
from selenium.webdriver.firefox.firefox_profile import FirefoxProfile

profile = FirefoxProfile()
profile.set_preference("browser.helperApps.neverAsk.saveToDisk", "text/plain, application/, text/csv, text/comma-separated-values, application/octet-stream")
profile.set_preference("", "C:\Downloads" )
browser = webdriver.Firefox(firefox_profile=profile)

browser.find_element_by_partial_link_text("Excel").click() # Download file
Asked By: user3580316



You cannot specify name of download file through selenium. However, you can download the file, find the latest file in the downloaded folder, and rename as you want.

Note: borrowed methods from google searches may have errors. but you get the idea.

import os
import shutil
filename = max([Initial_path + "\" + f for f in os.listdir(Initial_path)],key=os.path.getctime)
Answered By: parishodak

You can download the file and name it at the same time using urlretrieve:

import urllib

url = browser.find_element_by_partial_link_text("Excel").get_attribute('href')
urllib.urlretrieve(url, "/choose/your/file_name.xlsx")
Answered By: James Lemieux

There is something i would correct for @parishodak answer:

the filename here will only return the relative path (here the name of the file) not the absolute path.

That is why @FreshRamen got the following error after:

File "/usr/local/Cellar/python/2.7.10_2/Frameworks/Python.framework/Versions/2.7/lib/‌​python2.7/", 
line 72, in getctime return os.stat(filename).st_ctime OSError: 
[Errno 2] No such file or directory: '.localized'

There is the correct code:

import os
import shutil

filepath = 'c:downloads'
filename = max([filepath +""+ f for f in os.listdir(filepath)], key=os.path.getctime)
Answered By: toshiro92

Hope this snippet is not that confusing. It took me a while to create this and is really useful, because there has not been a clear answer to this problem, with just this library.

import os
import time
def tiny_file_rename(newname, folder_of_download):
    filename = max([f for f in os.listdir(folder_of_download)], key=lambda xa :   os.path.getctime(os.path.join(folder_of_download,xa)))
    if '.part' in filename:
        os.rename(os.path.join(folder_of_download, filename), os.path.join(folder_of_download, newname))
        os.rename(os.path.join(folder_of_download, filename),os.path.join(folder_of_download,newname))

Hope this saves someone’s day, cheers.

EDIT: Thanks to @Om Prakash editing my code, it made me remember that I didn’t explain the code thoughly.

Using the max([]) function could lead to a race condition, leaving you with empty or corrupted file(I know it from experience). You want to check if the file is completely downloaded in the first place. This is due to the fact that selenium don’t wait for the file download to complete, so when you check for the last created file, an incomplete file will show up on your generated list and it will try to move that file. And even then, you are better off waiting a little bit for the file to be free from Firefox.

EDIT 2: More Code

I was asked if 1 second was enough time and mostly it is, but in case you need to wait more than that you could change the above code to this:

import os
import time
def tiny_file_rename(newname, folder_of_download, time_to_wait=60):
    time_counter = 0
    filename = max([f for f in os.listdir(folder_of_download)], key=lambda xa :   os.path.getctime(os.path.join(folder_of_download,xa)))
    while '.part' in filename:
        time_counter += 1
        if time_counter > time_to_wait:
            raise Exception('Waited too long for file to download')
    filename = max([f for f in os.listdir(folder_of_download)], key=lambda xa :   os.path.getctime(os.path.join(folder_of_download,xa)))
    os.rename(os.path.join(folder_of_download, filename), os.path.join(folder_of_download, newname))
Answered By: dmb

Here is another simple solution, where you can wait until the download completed and then get the downloaded file name from chrome downloads.


# method to get the downloaded file name
def getDownLoadedFileName(waitTime):
    # switch to new tab
    # navigate to chrome downloads
    # define the endTime
    endTime = time.time()+waitTime
    while True:
            # get downloaded percentage
            downloadPercentage = driver.execute_script(
                "return document.querySelector('downloads-manager').shadowRoot.querySelector('#downloadsList downloads-item').shadowRoot.querySelector('#progress').value")
            # check if downloadPercentage is 100 (otherwise the script will keep waiting)
            if downloadPercentage == 100:
                # return the file name once the download is completed
                return driver.execute_script("return document.querySelector('downloads-manager').shadowRoot.querySelector('#downloadsList downloads-item').shadowRoot.querySelector('div#content  #file-link').text")
        if time.time() > endTime:


def getDownLoadedFileName(waitTime):

    endTime = time.time()+waitTime
    while True:
            fileName = driver.execute_script("return document.querySelector('#contentAreaDownloadsView .downloadMainArea .downloadContainer description:nth-of-type(1)').value")
            if fileName:
                return fileName
        if time.time() > endTime:

Once you click on the download link/button, just call the above method.

 # click on download link
 # get the downloaded file name
 latestDownloadedFileName = getDownLoadedFileName(180) #waiting 3 minutes to complete the download

JAVA + Chrome:

Here is the method in java.

public String waitUntilDonwloadCompleted(WebDriver driver) throws InterruptedException {
      // Store the current window handle
      String mainWindow = driver.getWindowHandle();
      // open a new tab
      JavascriptExecutor js = (JavascriptExecutor)driver;
     // switch to new tab
    // Switch to new window opened
      for(String winHandle : driver.getWindowHandles()){
     // navigate to chrome downloads
      JavascriptExecutor js1 = (JavascriptExecutor)driver;
      // wait until the file is downloaded
      Long percentage = (long) 0;
      while ( percentage!= 100) {
          try {
              percentage = (Long) js1.executeScript("return document.querySelector('downloads-manager').shadowRoot.querySelector('#downloadsList downloads-item').shadowRoot.querySelector('#progress').value");
          }catch (Exception e) {
            // Nothing to do just wait
     // get the latest downloaded file name
      String fileName = (String) js1.executeScript("return document.querySelector('downloads-manager').shadowRoot.querySelector('#downloadsList downloads-item').shadowRoot.querySelector('div#content #file-link').text");
     // get the latest downloaded file url
      String sourceURL = (String) js1.executeScript("return document.querySelector('downloads-manager').shadowRoot.querySelector('#downloadsList downloads-item').shadowRoot.querySelector('div#content #file-link').href");
      // file downloaded location
      String donwloadedAt = (String) js1.executeScript("return document.querySelector('downloads-manager').shadowRoot.querySelector('#downloadsList downloads-item').shadowRoot.querySelector(' #file-icon-wrapper img').src");
      System.out.println("Download deatils");
      System.out.println("File Name :-" + fileName);
      System.out.println("Donwloaded path :- " + donwloadedAt);
      System.out.println("Downloaded from url :- " + sourceURL);
     // print the details
     // close the downloads tab2
     // switch back to main window
      return fileName;

This is how to call this in your java script.

// download triggering step;
// now waituntil download finish and then get file name


Download deatils

File Name :-RubyMine-2019.1.2 (7).exe

Donwloaded path :- chrome://fileicon/C%3A%5CUsers%5Csupputuri%5CDownloads%5CRubyMine-2019.1.2%20(7).exe?scale=1.25x

Downloaded from url :-

RubyMine-2019.1.2 (7).exe

Answered By: supputuri

Using @dmb ‘s trick. Ive just made one correction: after .part control, below time.sleep(1) we must request filename again. Otherwise, the line below will try to rename a .part file, which no more exists.

Answered By: Negrali Selest

Here is the code sample I used to download pdf with a specific file name. First you need to configure chrome webdriver with required options. Then after clicking the button (to open pdf popup window), call a function to wait for download to finish and rename the downloaded file.

import os
import time
import shutil

from selenium import webdriver
from import WebDriverWait

# function to wait for download to finish and then rename the latest downloaded file
def wait_for_download_and_rename(newFilename):
    # function to wait for all chrome downloads to finish
    def chrome_downloads(drv):
        if not "chrome://downloads" in drv.current_url: # if 'chrome downloads' is not current tab
            drv.execute_script("'');") # open a new tab
            drv.switch_to.window(driver.window_handles[1]) # switch to the new tab
            drv.get("chrome://downloads/") # navigate to chrome downloads
        return drv.execute_script("""
            return document.querySelector('downloads-manager')
            .items.filter(e => e.state === 'COMPLETE')
            .map(e => e.filePath || e.file_path || e.fileUrl || e.file_url);
    # wait for all the downloads to be completed
    dld_file_paths = WebDriverWait(driver, 120, 1).until(chrome_downloads) # returns list of downloaded file paths
    # Close the current tab (chrome downloads)
    if "chrome://downloads" in driver.current_url:
    # Switch back to original tab
    # get latest downloaded file name and path
    dlFilename = dld_file_paths[0] # latest downloaded file from the list
    # wait till downloaded file appears in download directory
    time_to_wait = 20 # adjust timeout as per your needs
    time_counter = 0
    while not os.path.isfile(dlFilename):
        time_counter += 1
        if time_counter > time_to_wait:
    # rename the downloaded file
    shutil.move(dlFilename, os.path.join(download_dir,newFilename))

# specify custom download directory
download_dir = r'c:Downloadspdf_reports'

# for configuring chrome pdf viewer for downloading pdf popup reports
chrome_options = webdriver.ChromeOptions()
chrome_options.add_experimental_option('prefs', {
    "download.default_directory": download_dir, # Set own Download path
    "download.prompt_for_download": False, # Do not ask for download at runtime
    "download.directory_upgrade": True, # Also needed to suppress download prompt
    "plugins.plugins_disabled": ["Chrome PDF Viewer"], # Disable this plugin
    "plugins.always_open_pdf_externally": True, # Enable this plugin

# get webdriver with options for configuring chrome pdf viewer
driver = webdriver.Chrome(options = chrome_options)

# open desired webpage

# click the button to open pdf popup

# call the function to wait for download to finish and rename the downloaded file
wait_for_download_and_rename('My file.pdf')

# close the browser windows

Set timeout (120) to the wait time as per your needs.

Answered By: ePandit

I’ve come up with a different solution. Since you only care about the last downloaded file, then why not download it into a dummy_dir? So that, that file is going to be the only file in that directory. Once it’s downloaded, you can move it to your destination_dir as well as changing it’s name.

Here is an example that works with Firefox:

def rename_last_downloaded_file(dummy_dir, destination_dir, new_file_name):
    def get_last_downloaded_file_path(dummy_dir):
        """ Return the last modified -in this case last downloaded- file path.

            This function is going to loop as long as the directory is empty.
        while not os.listdir(dummy_dir):
        return max([os.path.join(dummy_dir, f) for f in os.listdir(dummy_dir)], key=os.path.getctime)

    while '.part' in get_last_downloaded_file_path(dummy_dir):
    shutil.move(get_last_downloaded_file_path(dummy_dir), os.path.join(destination_dir, new_file_name))

You can fiddle with the sleep time and add a TimeoutException as well, as you see fit.

Answered By: Burak Kaymakci

I am using the following function.
It checks for a file in the download location that you specify for chrome/selenium, and only is there is a file created as maxium 10 seconds ago (max_old_time), it renames it. Otherwise, it wait a maxium of 60 seconds (max_waiting_time)..

Not sure if is the best way, but it worked for me..

import os, shutil, time
from datetime import datetime

def rename_last_file(download_folder,destination_folder,newfilename):
    #Will wait for maxium max_waiting_time seconds for a new in folder.
    #Will rename only is the file creation has less than max_old_stime seconds.
    while True:
        for current_file in os.listdir(download_folder):
            current_file_fullpath=os.path.join(download_folder, current_file)
            if os.path.isfile(current_file_fullpath):
                if last_file_time==0:
                last_file_time=os.path.getctime(os.path.join(download_folder, last_file))
                if current_file_time>last_file_time and os.path.isfile(current_file_fullpath):
        last_file_fullpath=os.path.join(download_folder, last_file)
        if start_time-last_file_time<max_old_time:
        elif (>max_waiting_time:
            print("waiting file...")
Answered By: Cristian Avendaño

Here is a browser-agnostic solution that waits for the download to finish then returns the file name.

from datetime import datetime, timedelta

def wait_for_download_and_get_file_name():
    print(f'Waiting for download to finish', end='')

    while True:
        # Get the name of the file with the latest creation time
        newest_file_name = max([os.path.join(DOWNLOAD_DIR, f) for f in os.listdir(DOWNLOAD_DIR)], key=os.path.getctime)
        # Get the creation time of the file
        file_creation_time = datetime.fromtimestamp(os.path.getctime(newest_file_name))

        five_seconds_ago = - timedelta(seconds=5)
        if file_creation_time < five_seconds_ago:
            # The file with the latest creation time is too old to be the file that we're waiting for
            print(f'.', end='')
            print(f'nFinished downloading "{newest_file_name}"')

    return newest_file_name

Caveat: this will not work if you have more than one thread or process downloading files to the same directory at the same time.

Answered By: BrunoF

In my case i downloading and rename .csv files, also i using as a reference files that has ‘__’ in the title, but you can change ‘_’ for your specific usage.

Add this block after download on your selenium script.



files = [i for i in os.listdir(path) if os.path.isfile(os.path.join(path,i)) and 
            '_' in i]
if files != []:
    import os
    files = [i for i in os.listdir(path) if os.path.isfile(os.path.join(path,i)) and 
            '_' in i]
    os.rename(path + '\' +files[0], path + '\' +f'{string}.csv')

Answered By: Caio Euzébio
Categories: questions Tags: , , ,
Answers are sorted by their score. The answer accepted by the question owner as the best is marked with
at the top-right corner.