{"id":3445,"date":"2024-10-10T13:29:01","date_gmt":"2024-10-10T12:29:01","guid":{"rendered":"https:\/\/desairem.com\/wordpress\/?p=3445"},"modified":"2026-02-20T15:57:44","modified_gmt":"2026-02-20T14:57:44","slug":"disk-graph-snapshots","status":"publish","type":"post","link":"https:\/\/desairem.com\/wordpress\/disk-graph-snapshots\/","title":{"rendered":"Snapshots"},"content":{"rendered":"\n<p>After scanning a directory, you can export a snapshot of it. A snapshot is a file that can be opened in Disk Graph later to show the graph as it was at the time of the export.<\/p>\n\n\n\n<p>A snapshot can not only show a directory as it was at a certain point in time, but multiple snapshots exported at different times can also be opened as a <a href=\"https:\/\/desairem.com\/wordpress\/disk-graph-file-sequence\/\" data-type=\"post\" data-id=\"3396\">file sequence<\/a> to show the transition over time.<\/p>\n\n\n\n<p>A snapshot file can also be used to display custom hierarchical data inside Disk Graph. To learn how to create a custom snapshot file, please read the following section.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Format<\/h2>\n\n\n\n<p>A snapshot is saved as a file with the <code>.fssnapshot<\/code> extension, containing any of the following file attributes:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>name<\/li>\n\n\n\n<li>size<\/li>\n\n\n\n<li>allocatedSize<\/li>\n\n\n\n<li>creationDate<\/li>\n\n\n\n<li>modificationDate<\/li>\n<\/ul>\n\n\n\n<p>and having one of the following formats.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">TSV (tab-separated values)<\/h3>\n\n\n\n<p><a href=\"https:\/\/en.wikipedia.org\/wiki\/Tab-separated_values\">TSV<\/a> is the most efficient file format: it has a compact file size resulting in fast read and write speeds.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The first line indicates the data columns (the file attribute names), separated by tabs.<\/li>\n\n\n\n<li>The second line indicates the root directory. Its name may be empty, in which case the name of the snapshot file is displayed in Disk Graph.<\/li>\n\n\n\n<li>All following lines begin with a number of whitespaces equal to the depth of the file inside the root file, followed by the file attributes declared in the first line, separated by tabs. Regular files must indicate all declared attributes, while directories must skip <code>size<\/code> and <code>allocatedSize<\/code>, as they are calculated automatically. A required attribute may be left empty, in which case a default value is displayed.<\/li>\n<\/ul>\n\n\n\n<div class=\"wp-block-file\"><a id=\"wp-block-file--media-2e59ed02-d168-45cc-83c6-45c7b64c1726\" href=\"https:\/\/desairem.com\/wordpress\/wp-content\/uploads\/2024\/10\/My-Data-TSV.fssnapshot\">My Data TSV.fssnapshot<\/a><a href=\"https:\/\/desairem.com\/wordpress\/wp-content\/uploads\/2024\/10\/My-Data-TSV.fssnapshot\" class=\"wp-block-file__button wp-element-button\" download aria-describedby=\"wp-block-file--media-2e59ed02-d168-45cc-83c6-45c7b64c1726\">Download sample below<\/a><\/div>\n\n\n\n<p>Note: Safari may automatically append the <code>.txt<\/code> extension. Before opening the file in Disk Graph, you need to manually remove it.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>\"name\"\t\"size\"\t\"allocatedSize\"\t\"creationDate\"\t\"modificationDate\"\n\"\"\t\"2018-01-01T00:00:00Z\"\t\"2018-01-01T00:00:00Z\"\n \"a\"\t10\t10\t\"2018-01-01T00:00:00Z\"\t\"2018-01-01T00:00:00Z\"\n \"b\"\t\"2018-01-01T00:00:00Z\"\t\"2018-01-01T00:00:00Z\"\n  \"c\"\t10\t10\t\"2018-01-01T00:00:00Z\"\t\"2020-01-01T00:00:00Z\"\n  \"d\"\t\"2020-01-01T00:00:00Z\"\t\"2022-01-01T00:00:00Z\"\n   \"e\"\t10\t10\t\"2022-01-01T00:00:00Z\"\t\"2022-01-01T00:00:00Z\"\n   \"f\"\t\"2022-01-01T00:00:00Z\"\t\"2024-01-01T00:00:00Z\"\n    \"g\"\t10\t10\t\"2024-01-01T00:00:00Z\"\t\"2024-01-01T00:00:00Z\"\n \"h\"\t10\t10\t\"2018-01-01T00:00:00Z\"\t\"2018-01-01T00:00:00Z\"<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">JSON<\/h3>\n\n\n\n<p><a href=\"https:\/\/en.wikipedia.org\/wiki\/JSON\">JSON<\/a> is less efficient since the file attribute keys are repeated for every file, but it may be easier to create with programming languages that support it.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The root is a dictionary with the following keys:\n<ul class=\"wp-block-list\">\n<li><code>rootFile<\/code>: a file object.<\/li>\n\n\n\n<li><code>version<\/code>: the version number.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>A file object contains keys for its file attributes.\n<ul class=\"wp-block-list\">\n<li>Directories contain an additional key <code>contents<\/code>: an array of file objects. Directories may also skip the attributes <code>size<\/code> and <code>allocatedSize<\/code>, as they are calculated automatically.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<div class=\"wp-block-file\"><a id=\"wp-block-file--media-83542023-df76-48fc-b33f-0691d43fd9bb\" href=\"https:\/\/desairem.com\/wordpress\/wp-content\/uploads\/2024\/10\/My-Data-JSON.fssnapshot\">My Data JSON.fssnapshot<\/a><a href=\"https:\/\/desairem.com\/wordpress\/wp-content\/uploads\/2024\/10\/My-Data-JSON.fssnapshot\" class=\"wp-block-file__button wp-element-button\" download aria-describedby=\"wp-block-file--media-83542023-df76-48fc-b33f-0691d43fd9bb\">Download sample below<\/a><\/div>\n\n\n\n<p>Note: Safari may automatically append the <code>.txt<\/code> extension. Before opening the file in Disk Graph, you need to manually remove it.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"rootFile\" : {\n    \"contents\" : &#91;\n      {\n        \"contents\" : &#91;\n          {\n            \"contents\" : &#91;\n              {\n                \"allocatedSize\" : 10,\n                \"creationDate\" : \"2022-01-01T00:00:00Z\",\n                \"modificationDate\" : \"2022-01-01T00:00:00Z\",\n                \"name\" : \"e\",\n                \"size\" : 10\n              },\n              {\n                \"contents\" : &#91;\n                  {\n                    \"allocatedSize\" : 10,\n                    \"creationDate\" : \"2024-01-01T00:00:00Z\",\n                    \"modificationDate\" : \"2024-01-01T00:00:00Z\",\n                    \"name\" : \"g\",\n                    \"size\" : 10\n                  }\n                ],\n                \"creationDate\" : \"2022-01-01T00:00:00Z\",\n                \"modificationDate\" : \"2024-01-01T00:00:00Z\",\n                \"name\" : \"f\"\n              }\n            ],\n            \"creationDate\" : \"2020-01-01T00:00:00Z\",\n            \"modificationDate\" : \"2022-01-01T00:00:00Z\",\n            \"name\" : \"d\"\n          },\n          {\n            \"allocatedSize\" : 10,\n            \"creationDate\" : \"2018-01-01T00:00:00Z\",\n            \"modificationDate\" : \"2020-01-01T00:00:00Z\",\n            \"name\" : \"c\",\n            \"size\" : 10\n          }\n        ],\n        \"creationDate\" : \"2018-01-01T00:00:00Z\",\n        \"modificationDate\" : \"2018-01-01T00:00:00Z\",\n        \"name\" : \"b\"\n      },\n      {\n        \"allocatedSize\" : 10,\n        \"creationDate\" : \"2018-01-01T00:00:00Z\",\n        \"modificationDate\" : \"2018-01-01T00:00:00Z\",\n        \"name\" : \"a\",\n        \"size\" : 10\n      },\n      {\n        \"allocatedSize\" : 10,\n        \"creationDate\" : \"2018-01-01T00:00:00Z\",\n        \"modificationDate\" : \"2018-01-01T00:00:00Z\",\n        \"name\" : \"h\",\n        \"size\" : 10\n      }\n    ],\n    \"creationDate\" : \"2018-01-01T00:00:00Z\",\n    \"modificationDate\" : \"2018-01-01T00:00:00Z\",\n    \"name\" : \"\"\n  },\n  \"version\" : 1\n}<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"<p>After scanning a directory, you can export a snapshot of it. A snapshot is a file that can be opened in Disk Graph later to show the graph as it was at the time of the export. A snapshot can not only show a directory as it was at a certain point in time, but [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"wp-custom-template-disk-graph-help-post","format":"standard","meta":{"footnotes":""},"categories":[8],"tags":[],"class_list":["post-3445","post","type-post","status-publish","format-standard","hentry","category-diskgraph-help"],"_links":{"self":[{"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/posts\/3445","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/comments?post=3445"}],"version-history":[{"count":10,"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/posts\/3445\/revisions"}],"predecessor-version":[{"id":5630,"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/posts\/3445\/revisions\/5630"}],"wp:attachment":[{"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/media?parent=3445"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/categories?post=3445"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/tags?post=3445"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}