malhuda/neofetch
1
0
Fork 0
mirror of https://github.com/dylanaraps/neofetch.git synced 2025-02-20 11:23:39 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
Page: Custom Ascii art file format
Pages
Config File Custom Ascii art file format Customizing Info Dependencies Frequently Asked Questions Getting Started Home Image Backends Images in the terminal Installation Neofetch vs. Screenfetch Operating System Support Shellcheck Exclusions Terminal and Terminal Font detection What is Waifu Crop?
Clone
8
Custom Ascii art file format
Ossama Hjaji edited this page 2019-10-30 09:43:50 +01:00
Table of Contents

This is the format neofetch uses for it's ascii art files and the format you should follow when adding ascii art to neofetch or when specifying custom ascii art with: --ascii /path/to/ascii_file.

The ascii art is read as plaintext so the only character you have to escape is the backslash \.

Here's an example:

# ascii/distro/redstar
${c1}                    ..
                  .oK0l
                 :0KKKKd.
               .xKO0KKKKd
              ,Od' .d0000l
             .c;.   .'''...           ..'.
.,:cloddxxxkkkkOOOOkkkkkkkkxxxxxxxxxkkkx:
;kOOOOOOOkxOkc'...',;;;;,,,'',;;:cllc:,.
 .okkkkd,.lko  .......',;:cllc:;,,'''''.
   .cdo. :xd' cd:.  ..';'',,,'',,;;;,'.
      . .ddl.;doooc'..;oc;'..';::;,'.
        coo;.oooolllllllcccc:'.  .
       .ool''lllllccccccc:::::;.
       ;lll. .':cccc:::::::;;;;'
       :lcc:'',..';::::;;;;;;;,,.
       :cccc::::;...';;;;;,,,,,,.
       ,::::::;;;,'.  ..',,,,'''.
    ```
    ........          ......

Rules:

  • You have to escape \. (eg \\)

Features:

  • You can use ${c1} to ${c6} to color the ascii. These are evaluated after we read the file.
  • You can pass the flag --ascii_colors 1 2 3 4 5 6 to set the colors.
    • This changes the values of ${c1} to ${c6}
    • --ascii_colors 2 5 6 1 changes ${c1} to Green, ${c2} to Magenta and etc.