---

[Click/tap here to expand/collapse this entire article]

FolderArtist

[Click/tap here to expand/collapse the title section]

📂️🎨️📁️💾️ The official source repository for FolderArtist, a tool for automating the process of adding icons to file folders.

• View documentation repository
• View discussions

---

Current challenges

[Click/tap here to expand/collapse the current challenges section]

• I need to find development time to work on this project
• I don't know how to interact with any Linux API to be able to change folder art through a shell script
• I need a maintainer for this project
• I need to find out if this is a safe idea (see §Concerns)

---

Original draft

[Click/tap here to expand/collapse the original draft section]

The original concept draft for this project (written in quarter 4 of 2023)

FolderArtist

A tool to update folderart automatically

Write in: Shell

Detect a file sequence

{ /FolderArt/ }

- [ ] Apply folder art to source folder (i.e: /FolderArt/)
- [ ] Apply folder art to folder 1 layer deeper (i.e: /Cat-Pictures/FolderArt/)
- [ ] Apply folder art to folder 2 layers deeper (i.e: /Pictures/Cat-Pictures/FolderArt/) return error if non-existent
- [ ] Apply folder art to folder 3 layers deeper (i.e: /home/Pictures/Cat-Pictures/FolderArt/) return error if non-existent
- [ ] Custom pattern (depth)

{ /File.icons }

- [ ] Use first file in A-Z order
- [ ] Pick a random file

{ /File.types }

- [ ] Ignore JPG files
- [ ] Ignore JPEG files
- [ ] Ignore TIF files
- [ ] Ignore TIFF files
- [ ] Ignore BMP files
- [ ] Ignore RAW files
- [ ] Ignore XCF files
- [ ] Ignore KRA files
- [ ] Ignore JP2 files
- [ ] Ignore PNG files
- [ ] Ignore GIF files
- [ ] Ignore JIF files
- [ ] Ignore JFIF files
- [ ] Ignore SVG files
- [ ] Ignore PNS files
- [ ] Ignore PSD files
- [ ] Ignore WEBP files
- [ ] Ignore NETP files
- [ ] Ignore ICO files
- [ ] Ignore HEIF files
- [ ] Ignore DIB files
- [ ] Ignore EPS files
- [ ] Ignore PDF files
- [ ] Ignore files without an extension
- [ ] Only ignore specific image files when others are available

{ /Prog.config }

- [ ] Create .desktop entry files
- [ ] Create desktop.ini files

{ /Prog.de.config }

- [ ] Prefer GNOME 2
- [ ] Prefer GNOME 3
- [ ] Prefer GNOME 40
- [ ] Prefer KDE 3
- [ ] Prefer KDE 4
- [ ] Prefer KDE 5
- [ ] Prefer XFCE
- [ ] Prefer LXDE
- [ ] Prefer LXQT
- [ ] Prefer CINNAMON
- [ ] Prefer Windows Shell
- [ ] Prefer Aqua

---

Benefits

[Click/tap here to expand/collapse the benefits section]

Custom folder art can transfer between systems seamlessly through automation, rather than manual labor, and I won't have to redo the 4000+ folders on my new laptop.

---

Concerns

[Click/tap here to expand/collapse the concerns section]

• I have been applying folder art manually, and I have noted that navigaging through folders get slower when doing lots of folder art modification, especially for large preview images. I fear that what I did (adding at least 4000 custom folder icons throughout my system) may be contributing to system instability. I fear doing this project and having an automatic process may cause extreme system instability, high memory usage, and crashes.
• I feel this may be limited to certain desktop environments only. From testing, custom folder art has shown up only in Nautilus (GNOME/GNOME files) and not Dolphin (KDE/Dolphin)

---

Further documentation

[Click/tap here to expand/collapse the benefits section]

Further documentation is available in a separate repository (seanpm2001/FolderArtist_Docs/)

---

File info

Click/tap here to expand/collapse this section

• File type: Markdown (*.md *.mkd *.mdown *.markdown)
• File version: 1 (2023, Monday, December 18th at 05:37 pm PST)
• Line count (including blank lines and compiler line): 266
• Word count: 1,411
• Character count (including spaces): 09,666
• Character count (excluding spaces): 08,079
• Size (in bytes): 09,687
• Current article language: English (EN_USA) / Markdown (CommonMark) / HTML5 (HyperText Markup Language 5.3)
• Encoding: UTF-8 (Emoji 12.0 or higher recommended)
• All times are UTC-7 (PDT/Pacific Time) (Please also account for DST (Daylight Savings Time) for older/newer entries up until it is abolished/no longer followed)

Note On 2022, Sunday, March 13th at 2:00 am PST, the time jumped ahead 1 hour to 3:00 am.

Note You may need special rendering support for the <details> HTML tag being used in this document

---

File history

[Click/tap here to expand/collapse the file history section]

Version 1 (2023, Monday, December 18th at 05:37 pm PST)

[Click/tap here to expand/collapse the file history entry for version 1]

• View the archive of version 1
• This release was made by @seanpm2001

Note This is the first version of this file.

Changes:

• Started the file
• Made all sections (and the article itself) collapse-able
• Updated the Title section
• • Added an anchor link to the section heading
• • Referenced the FolderArtist logo (without wordmark)
• • Referenced the FolderArtist logo (with wordmark)
• • Made the section collapse-able
• Added the Current challenges section
• • Added an anchor link to the section heading
• • Made the section collapse-able
• Added the Original draft section
• • Added an anchor link to the section heading
• • Made the section collapse-able
• Added the Benefits section
• • Added an anchor link to the section heading
• • Made the section collapse-able
• Added the Concerns section
• • Added an anchor link to the section heading
• • Made the section collapse-able
• Added the Further documentation section
• • Added an anchor link to the section heading
• • Made the section collapse-able
• Updated the File info section
• • Added an anchor link to the section heading
• • Made the section collapse-able
• • Added the file type
• • Added the file version
• • Added the line count (with spaces)
• • Added the line count (without spaces)
• • Added the word count
• • Added the character count
• • Added the byte count
• • Added the language
• • Added the encoding
• • Added the DST warning
• • Added the special rendering note
• Added the File history section
• • Added an anchor link to the section heading
• • Made the section collapse-able
• • Added an entry for version 1
• Added the Footer
• • Added an anchor link to the section heading
• • Added an anchor link to the section subheading
• • Made the section collapse-able
• No other changes in version 1

---

End of file history

---

Footer

[Click/tap here to expand/collapse the footer section]

You have reached the bottom of this page.

• Back to top
• Exit to GitHub

EOF

---