{"id":16713128,"url":"https://github.com/picrap/exfat","last_synced_at":"2026-03-04T15:31:58.276Z","repository":{"id":90836155,"uuid":"102092509","full_name":"picrap/ExFat","owner":"picrap","description":"exFAT read/write","archived":false,"fork":false,"pushed_at":"2018-02-18T22:00:56.000Z","size":562,"stargazers_count":8,"open_issues_count":4,"forks_count":5,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-10T06:07:45.562Z","etag":null,"topics":["exfat","filesystem","partition"],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/picrap.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-09-01T08:37:19.000Z","updated_at":"2023-01-04T13:40:22.000Z","dependencies_parsed_at":"2023-06-03T03:30:13.523Z","dependency_job_id":null,"html_url":"https://github.com/picrap/ExFat","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/picrap%2FExFat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/picrap%2FExFat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/picrap%2FExFat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/picrap%2FExFat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/picrap","download_url":"https://codeload.github.com/picrap/ExFat/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248166925,"owners_count":21058481,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["exfat","filesystem","partition"],"created_at":"2024-10-12T20:45:36.556Z","updated_at":"2026-03-04T15:31:58.239Z","avatar_url":"https://github.com/picrap.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ExFat\n\nAn exFAT accessor library.\n\n## Summary\n\n**ExFat** allows to manipulate an exFAT formatted partition (provided as a `System.IO.Stream`).\nIt comes with two packages:\n* The core package `ExFat.Core` available from [NuGet](https://www.nuget.org/packages/ExFat.Core), which allows simple exFAT management at three different levels (partition, entry and path).\n* The DiscUtils package `ExFat.DiscUtils` available from [NuGet](https://www.nuget.org/packages/ExFat.DiscUtils), which depends on [`DiscUtils`](https://www.nuget.org/packages/DiscUtils) package.\n\nCurrently, `ExFat.Core` does what it says: files/directories manipulation at any level.\nDiscUtils support is on its way and should be released in the very next few days.\n\n`ExFat.Core` works at three levels:\n1. Lowest level: partition access. This allows to manipulate clusters, allocation bitmap, directory entries and clusterr streams.\n2. Middle level: entry access. Files/directories can be used to read/write content.\n3. High level: path access. This works as you would expect using file paths.\n\n`ExFat.DiscUtils` is also a high-level access (using paths) with implementation for [`DiscUtils`](https://github.com/DiscUtils/DiscUtils).\n\nBecause it is still under development, you can see pending features state [here](https://github.com/picrap/ExFat/labels/feature).\n\n## Samples\n\nAll examples assume you have a `Stream` containing an exFAT partition.\n```csharp\n// Access at partition-level. Most efficient, most dangerous.\n// Integrity is not guaranteed at this level, \n// user needs to make all neceassary operations in right order.\nusing(var partition = new ExFatPartition(partitionStream))\n{\n    // returns all entries (including bitmap, volume label, etc.) from root directory\n    var entries = partition.GetEntries(partition.RootDirectoryDataDescriptor);\n\n    // returns all files/directories meta entries\n    var metaEntries = partition.GetMetaEntries(partition.RootDirectoryDataDescriptor);\n\n    // assuming there is one, of course (but we're in a sample)\n    var someDirectory = metaEntries.First(e =\u003e e.IsDirectory);\n    var directoryMetaEntries = partition.GetMetaEntries(someDirectory.DataDescriptor);\n\n    var someFile = metaEntries.First(e =\u003e !e.IsDirectory);\n    using(var dataStream = partition.OpenDataStream(someFile.DataDescriptor, FileAccess.Read))\n    { }\n}\n```\n```csharp\n// Access at entry level. Quite fast, since user has to track entries.\n// Integrity is guaranteed. File attributes are not honored (maybe one day...)\nusing(var entryFilesystem = new ExFatEntryFilesystem(partitionStream))\n{\n    var someFileEntry = entryFilesystem.FindChild(filesystem.RootDirectory, \"someFile\");\n    using(var fileStream = entryFilesystem.OpenFile(someFileEntry, FileAccess.Read)\n    { }\n\n    // finding one file in a directory requires two steps\n    var someDirectoryEntry = entryFilesystem.FindChild(filesystem.RootDirectory, \"someDirectory\");\n    var someChildFileEntry = entryFilesystem.FindChild(someDirectoryEntry, \"someDirectory\");\n}\n```\n```csharp\n// Access at path level. Uses a path cache to retrieve entries, \n// so speed is not as good (but not that bad either)\n// since there is not drive, paths only specify the directory chain\n// (so \"a\\b\\c\" for example)\nusing(var pathFilesystem = new ExFatPathFilesystem(partitionStream))\n{\n    var rootEntries = pathFilesystem.EnumerateEntries(\"\\\"); // \"\" works too for root\n    var childEntries = pathFilesystem.EnumerateEntries(@\"\\somedir\"); // \"somedir\" works too\n    using(var s = pathFilesystem.Open(@\"a\\b\\c\", FileMode.Open, FileAccess.Read)\n    { }\n}\n```\n\nCurrent build status (for people who care... If you ever meet one): [![Build status](https://ci.appveyor.com/api/projects/status/k0jf58a0e5g2ue2h?svg=true\n)](https://ci.appveyor.com/project/picrap/exfat)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpicrap%2Fexfat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpicrap%2Fexfat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpicrap%2Fexfat/lists"}