<!-- # hard line break macro for HTML -->

# fiftyone.utils.data.converters

Dataset format conversion utilities.

Copyright 2017-2026, Voxel51, Inc.
<br/>
[voxel51.com](https://voxel51.com/)
<br/>
<br/>

**Functions:**

| [`convert_dataset`](#fiftyone.utils.data.converters.convert_dataset)([input_dir, input_type, ...])   | Converts a dataset stored on disk to another format on disk.   |
|------------------------------------------------------------------------------------------------------|----------------------------------------------------------------|

### fiftyone.utils.data.converters.convert_dataset(input_dir=None, input_type=None, input_kwargs=None, dataset_importer=None, output_dir=None, output_type=None, output_kwargs=None, dataset_exporter=None, overwrite=False)

Converts a dataset stored on disk to another format on disk.

The input dataset may be specified by providing either an `input_dir` and
a corresponding `input_type` or by providing a `dataset_importer`.

The output dataset may be specified by providing either an `output_dir`
and a corresponding `output_type` or by providing a `dataset_exporter`.

* **Parameters:**
  * **input_dir** (*None*) – the input dataset directory
  * **input_type** (*None*) – the [`fiftyone.types.Dataset`](fiftyone.types.md#fiftyone.types.Dataset) type of the
    dataset in `input_dir`
  * **input_kwargs** (*None*) – optional kwargs dict to pass to the constructor of
    the [`fiftyone.utils.data.importers.DatasetImporter`](fiftyone.utils.data.importers.md#fiftyone.utils.data.importers.DatasetImporter) for the
    `input_type` you specify
  * **dataset_importer** (*None*) – a
    [`fiftyone.utils.data.importers.DatasetImporter`](fiftyone.utils.data.importers.md#fiftyone.utils.data.importers.DatasetImporter) to use to
    import the input dataset
  * **output_dir** (*None*) – the directory to which to write the output dataset
  * **output_type** (*None*) – the [`fiftyone.types.Dataset`](fiftyone.types.md#fiftyone.types.Dataset) type to write
    to `output_dir`
  * **output_kwargs** (*None*) – optional kwargs dict to pass to the constructor
    of the [`fiftyone.utils.data.exporters.DatasetExporter`](fiftyone.utils.data.exporters.md#fiftyone.utils.data.exporters.DatasetExporter) for
    the `output_type` you specify
  * **dataset_exporter** (*None*) – a
    [`fiftyone.utils.data.exporters.DatasetExporter`](fiftyone.utils.data.exporters.md#fiftyone.utils.data.exporters.DatasetExporter) to use to
    export the dataset
  * **overwrite** (*False*) – whether to delete existing directories before
    performing the export (True) or to merge the export with existing
    files and directories (False)