Class: QgsFileDownloaderDialog

class qgis.gui.QgsFileDownloaderDialog(url: QUrl, outputFileName: str, authcfg: str = '')

Bases: PyQt5.QtWidgets.QProgressDialog


  • url – the download url

  • outputFileName – file name where the downloaded content will be stored

  • authcfg – optionally apply this authentication configuration

QgsFileDownloaderDialog is a QProgressDialog subclass which handles file downloads and user feedback.

Internally, it uses QgsFileDownloader to handle the download, while showing progress via a progress dialog and supporting cancellation.


Until QGIS 3.0 this functionality was available via QgsFileDownloader.

actionEvent(self, QActionEvent)
changeEvent(self, QEvent)
childEvent(self, QChildEvent)
closeEvent(self, QCloseEvent)
connectNotify(self, QMetaMethod)
contextMenuEvent(self, QContextMenuEvent)
create(self, window: sip.voidptr = 0, initializeWindow: bool = True, destroyOldWindow: bool = True)
customEvent(self, QEvent)
destroy(self, destroyWindow: bool = True, destroySubWindows: bool = True)
disconnectNotify(self, QMetaMethod)

Emitted when the download was canceled by the user [signal]


Emitted when the download has completed successfully [signal]


Emitted when an error makes the download fail [signal]


errorMessages (Iterable[str]) –


Emitted always when the downloader exits [signal]


Emitted when data are ready to be processed [signal]

  • bytesReceived (int) –

  • bytesTotal (int) –

dragEnterEvent(self, QDragEnterEvent)
dragLeaveEvent(self, QDragLeaveEvent)
dragMoveEvent(self, QDragMoveEvent)
dropEvent(self, QDropEvent)
enterEvent(self, QEvent)
event(self, QEvent) bool
eventFilter(self, QObject, QEvent) bool
focusInEvent(self, QFocusEvent)
focusNextChild(self) bool
focusNextPrevChild(self, bool) bool
focusOutEvent(self, QFocusEvent)
focusPreviousChild(self) bool
hideEvent(self, QHideEvent)
initPainter(self, QPainter)
inputMethodEvent(self, QInputMethodEvent)
isSignalConnected(self, QMetaMethod) bool
keyPressEvent(self, QKeyEvent)
keyReleaseEvent(self, QKeyEvent)
leaveEvent(self, QEvent)
metric(self, QPaintDevice.PaintDeviceMetric) int
mouseDoubleClickEvent(self, QMouseEvent)
mouseMoveEvent(self, QMouseEvent)
mousePressEvent(self, QMouseEvent)
mouseReleaseEvent(self, QMouseEvent)
moveEvent(self, QMoveEvent)
nativeEvent(self, Union[QByteArray, bytes, bytearray], sip.voidptr) Tuple[bool, int]
paintEvent(self, QPaintEvent)
receivers(self, PYQT_SIGNAL) int
resizeEvent(self, QResizeEvent)
sender(self) QObject
senderSignalIndex(self) int
sharedPainter(self) QPainter
showEvent(self, QShowEvent)
tabletEvent(self, QTabletEvent)
timerEvent(self, QTimerEvent)
wheelEvent(self, QWheelEvent)