nordtheme / dircolors

An arctic, north-bluish clean and elegant dircolors theme.

An arctic, north-bluish clean and elegant dircolors theme.

Designed for a fluent and clear workflow based on the Nord color palette.

Getting started

Visit the official website to learn all about the features, how to install and activate the theme, supported data and node types and more from the official documentations.

Quick Start

Nord dircolors can be installed for all application that respect the LS_COLORS environment variable like GNU core utils ls, tree or modern projects like fd.

Download the dir_colors file and place it as ~/.dir_colors in your home directory.

For more details see the official installation & activation guide as well as the GNU dircolors documentations.

Latest Development State

To always use the latest development state of Nord dircolors, clone the repository and create a symbolic link of the src/dir_colors file to ~/.dir_colors in your home directory afterwards:

ln -sr "$PWD/src/dir_colors" ~/.dir_colors

Activation

To activate and use Nord dircolors as your default color theme for all sessions, load the theme with dircolors by adding the following snippet to the configuration file of your shell (~/.bashrc, ~/.zshrc, …):

test -r ~/.dir_colors && eval $(dircolors ~/.dir_colors)

Features

Beautiful highlighting for all your bits and bytes.

Support for a wide range of data and node types — From symbolic links, executables up to file system permissions.

Directories with different file system permissions.

Various Unix file types like device files and domain sockets.

Contributing

Nord is an open source project and we love to receive contributions from the community!

There are many ways to contribute, from writing- and improving documentation and tutorials, reporting bugs, submitting enhancement suggestions that can be added to Nord by submitting pull requests.

Please take a moment to read Nord's full contributing guide to learn about the development process, the project's used styleguides, branch organization and versioning model.

The guide also includes information about minimal, complete, and verifiable examples and other ways to contribute to the project like improving existing issues and giving feedback on issues and pull requests.

Copyright © 2016-present Sven Greb

dircolors's Issues

Nord Docs Transition

➜ Please see the corresponding issue nordtheme/web#159 for tasks on the side of Nord Docs.

This issue documents the transfer of all documentations and content assets of Nord dircolors to the shiny new website and documentation of Nord, the new single-source-of-truth™.

Git Repository Size: Statistic Comparison

To get some numbers about the size changes of the Git repository before and after the migration, these are the statistics of the current repository state.

Processing blobs: 35                        
Processing trees: 20                        
Processing commits: 20                        
Matching commits to trees: 20                        
Processing annotated tags: 2                        
Processing references: 6                        
| Name                         | Value     | Level of concern               |
| ---------------------------- | --------- | ------------------------------ |
| Overall repository size      |           |                                |
| * Commits                    |           |                                |
|   * Count                    |    20     |                                |
|   * Total size               |  7.00 KiB |                                |
| * Trees                      |           |                                |
|   * Count                    |    20     |                                |
|   * Total size               |  3.23 KiB |                                |
|   * Total tree entries       |    84     |                                |
| * Blobs                      |           |                                |
|   * Count                    |    35     |                                |
|   * Total size               |  1.40 MiB |                                |
| * Annotated tags             |           |                                |
|   * Count                    |     2     |                                |
| * References                 |           |                                |
|   * Count                    |     6     |                                |
|                              |           |                                |
| Biggest objects              |           |                                |
| * Commits                    |           |                                |
|   * Maximum size         [1] |   849 B   |                                |
|   * Maximum parents      [1] |     2     |                                |
| * Trees                      |           |                                |
|   * Maximum entries      [2] |    11     |                                |
| * Blobs                      |           |                                |
|   * Maximum size         [3] |   876 KiB |                                |
|                              |           |                                |
| History structure            |           |                                |
| * Maximum history depth      |    17     |                                |
| * Maximum tag depth      [4] |     1     |                                |
|                              |           |                                |
| Biggest checkouts            |           |                                |
| * Number of directories  [5] |     3     |                                |
| * Maximum path depth     [5] |     3     |                                |
| * Maximum path length    [5] |    55 B   |                                |
| * Number of files        [5] |    16     |                                |
| * Total size of files    [6] |  1.30 MiB |                                |
| * Number of symlinks         |     0     |                                |
| * Number of submodules       |     0     |                                |

[1]  96b20ecb385e2068bb313cf47bbcbba76ca27885 (refs/heads/develop)
[2]  9fc5aad026c5fcbf2be79967165cd4ef097b42bc (refs/heads/develop:src/assets)
[3]  598dff623ed48c5382994b37ca004d1c0cb61c5c (refs/heads/develop:src/assets/nord-dircolors-banner.ai)
[4]  3233bb13d4cae0d85fa7b7962755ba4edeb1b60c (refs/tags/v0.1.0)
[5]  41760230b90f9a6af11d23111b1c514a40c7bf1a (refs/heads/develop^{tree})
[6]  758730b1eb340436b5558550905b9b47a7b3131d (refs/heads/master^{tree})

The report has been generated using GitHub's awesome git-sizer project: git-sizer --verbose

Documentation suggestions

Nord is amazing! Tweeted about it yesterday but forgot to CC your handle. Seems to strike a chord!

Two quick suggestions for nord-dircolors

1. My ~/.bashrc has the line test -r ~/.dircolors && eval "$(dircolors -b ~/.dircolors)" || eval "$(dircolors -b)" so maybe this should install to ~/.dircolors and/or offer a soft link?
2. Might be worthwhile to remind people that /usr/bin/dircolors is needed to create LS_COLORS or else nothing happens?

Northern Post — The state and roadmap of Nord

→ The announcement has been published in Nord's new home on GitHub! ←

Programmer's colors

Hi,

Do you have any plans to color more file extensions, especially for programming? .js, .ts, .cs, .h, .cpp, .json, etc.
Would you accept a contribution for such extensions?

Migrate to MIT license

Subtask of nordtheme/nord#55

Adapt to the MIT license migration of the main Nord project. Detailed information can be found in the main task ticket.

Tasks

• Update all license SVG badges
• Update the LICENSE.md content
• Update- and simplify all source code comment header

Profile not listed in "profiles"

I cloned the repo and ran the nord.sh but I do not see any profile in profiles :/

(I use mint 18)

Can't seem to get this working with urxvt

I have the theme working in urxvt (via .Xresources), vim, and tmux but I can't get any colors to show up by following the nord-dircolors documentation. Any ideas?

Xubuntu 20.04 (Linux version 5.4.0-47-generic)
zsh v5.8
rxvt-unicode v9.22

Fix image asset URLs after `nord-docs` GitHub flow and `main` branch migration

The URLs to image assets are broken due to the recent GitHub flow migration in the nord-docs repository as the switch from the master to main branch. This is also in preparation for a very big change that is scheduled to be announced in a few weeks which require the paths to be updated again, but in the meantime these should definitely be fixed in almost all Nord port repositories.

Not working for Ubuntu 20.04 - Alacritty

1. I downloaded and kept the dir_colors as ~/.dir_colors
2. Added test -r "~/.dir_colors" && eval $(dircolors ~/.dir_colors) command to the ~/.bashrc and ~/.zshrc both. After sourcing the ls command does not show NORD colors.

Please help.

Typo in project description

📝 A arctic ... -> An arctic ...

This is a 🔀 sub-task of nord #20.

readme instructions are incorrect

In the README.MD,

the following command is suggested:

test -r "~/.dir_colors" && eval $(dircolors ~/.dir_colors)

but it won't work ( tested on Debian 10, bash 5.0-4 ).

The quotes need to be ommited and the command should be:

test -r ~/.dir_colors && eval $(dircolors ~/.dir_colors)

The problem is explained here: https://serverfault.com/a/417255

Improper directory colors in iterm/tmux session

There is an incorrect background color for directories with file permissions 0777. Below is a screenshot. It actually seems that the theme isn't working at all after going through the installation instructions.

https://imgur.com/gallery/8FRdVKC

I am using iTerm2/tmux/zsh.

This is in my .zshrc: test -r "~/.dir_colors" && eval $(dircolors ~/.dir_colors)

Any ideas?

One liner for csh

Hi, is there a one liner to activate in csh?

Not working in bash+kitty

the $LS_COLORS variable gets updated appropriately but no change in the ls output

256color support is missing

If I use the suggested dir_colors along with nord-gnome-terminal I miss out on all coloring !

OS: Fedora release 23 (Twenty Three)
Terminal: GNOME Terminal 3.18.3

dir_colors theme

Implement the main dir_colors theme file.

Design Concept

Global Defaults

Permissions

Directories are colored by nord9 using a bold font.

Directories with the t permission flag should use a nord9 background, nord4 foreground and the font should be underlined while directories that addionally have the o+w permission flag should use a bold font style.

Directories with the 777 permission value should be underlined.

Links

Symbolic links should be colored by nord8 while the font of hard links should be addionally underlined.

The foreground of a invalid symbolic link should be colored by nord11 while nonexistent targets should use a nord11 background and a bold nord4 foreground.

Executables

Executables should be colored by nord7 using a bold font.

Blocks and Sockets

Character devices should be colored by nord13 while block devices should addionally use a bold font.

Sockets should also be colored by nord13 and addionally using a underlined font.

Capabilities

The GID g+s and UID u+s capability flags should be colored by the default nord4 using a bold font.

Named pipe (fifo)

Named pipes (fifo) should be colored by nord7 using a bold font.

Extension Pattern

Media

Extension for media based types like images, audio, videos and documents should be colored by nord14 while archive- and compression types should addionally use a bold font.

Ignores

This themes should colorize extensions that are produced during a application runtime which should be ignored by version control systems with the dimmed color nord4.

Instruction to uninstall

My Mac keep the nord colors when ls even though I have deleted the .dir_colors file. How can I uninstall it completely?

`nordtheme` organization migration

As part of the “Northern Post — The state and roadmap of Nord“ announcement, this repository will be migrated to the nordtheme GitHub organization.
This issue is a task of nordtheme/nord#185 epic (tasklist).

Adapt remaining `arcticicestudio` "fade-out" changes

With the retirement of the Arctic Ice Studio personal & Nord project brand various migrations to the svengreb GitHub account of other projects were also completed within the last weeks. There are also changes in Nord projects like nordtheme/web that other projects depended on and can now be adapted as well.
Therefore all Nord projects must adapt these changes which includes…

• the migration and repository name change of arcticicestudio/nord-docs — all references must be updated.
• the migration of the arcticicestudio/styleguide-git repository to the svengreb real-in-person identity — all references and used npm packages must be updated.
• the migration of the arcticicestudio/styleguide-javascript repository to the svengreb real-in-person identity — all references and used npm packages must be updated.
• the migration of the arcticicestudio/styleguide-markdown repository to the svengreb real-in-person identity — all references and used npm packages must be updated.

BUG?? Dircolor not working in zsh and alacritty

Hello,
I am using alacritty with the nord colour pallete and zsh but it's not showing the nord colours in the ls command(it might also not be showing these in others but I have just tested it with ls) BUT it shows them in BASH for whatever reason.....
And yes, I have followed the instructions and put test -r "~/.dir_colors" && eval $(dircolors ~/.dir_colors) in my bash and zshrc as well as put the dir colors file in my home directory.

Install script

Implement a install script for an automated installation.
It should provide options to

• specify a custom path to the theme file
• increase the verbosity
• print a help message

This includes error- and exit code handling.

The default color theme file src/dir_colors as implemented in #1 must be moved the gome directory and renamed to .dir_colors.

Documentation and/or support for MacOS

I just tried using this package and came to the realisation that dircolors only works on GNU e.g. Linux. and that MacOs uses LS colors https://gist.github.com/smutnyleszek/c44124908a9b737e372c28aaf0048b44

I found some instructions on how to get dircolors working by installing coreutils and adding the following code snippet to either bashrc or zshrc.

  test -e ~/.dir_colors && \
     eval `gdircolors -b ~/.dir_colors`

source: http://www.conrad.id.au/2013/07/making-mac-os-x-usable-part-1-terminal.html

I can verify that this will indeed change the LS_COLORS but the directory highlighting is still the same. Am I missing something ?

I'm using Alacritty + Tmux + Zsh and have the respective Nord theme installed for all of them.