ll - a more informative ls, based on k
ll is an alternative to k, which was created to make
directory listings more informative and readable, using colour to add
visual weight to important information in the listing.
k only works with zsh, and I've found that it can
occasionally be a little slow when working with large directories or
with large git repositories. I was looking for a project which would
be a good match to learn/use nim, and this seemed like a great
opportunity to make something a little more general-purpose that could
be used without the zsh dependency.
Calling ll provides a full file listing for a directory, similar to calling
ls -l.
Files sizes are graded from green for small (< 1k), to red for huge (> 1mb).
Human readable files sizes can be shown by using the -h or --human flag.
Dates fade with age, so that recently changed files/directories can be easily identified.
Broken symlinks are identified by a ~> (tilde-arrow) leading symbol
and differing colors.
ll provides easy-to-understand information about the git status of
your files/directories.
When listing a directory which contains git repos, ll displays the
active state of those repos:
When listing files/directories within a working tree, ll displays
the active state of each file, and the overall state for directories:
ll improves on k's rendering speeds. Currently ll is comparable
to ls display times when using the --no-vcs flag. Listing git
repositories and trees take a little longer, but even with large
listings with many git-tracked entries ll is still sub-second.
The latest binary distribution is avilable here.
It is also possible to build and install using the following instructions:
- Nim, minimum v1.2.*
make
Firstly install Nim. I personally use asdf to manage Nim
versions on my machine. With asdf installed, this is as simple as
calling asdf install nim latest.
Once Nim is installed, clone this repository. From within the cloned
directory, call make install which will build ll into the working
directory and will then opy the resulting ll binary to /usr/local/bin.
$ ll
That's it. For more options, pass -? or --help.
- Full file listing
- File weight colours
- "Rotting" dates
- Display symlink status
- Git status on entire repos
- Git status on files within a working tree
- Sort output by size
- Sort output by modified time
- Sort output in reversed order
- Options for filtering directories
- Remove dependency on PCRE (using the
regexpackage) - Installable via Homebrew
- Support light themes
- Support globs
Fixes over k
khas an odd behaviour; givenpwdis a git-tracked directory, if youk somedirwheresomedircontains git-tracked directories but isn't itself tracked,kreports as though it is working inside a work-tree.llreports this as one would expect, as thoughpwdissomedir. UPDATE: This has now been fixed.
According to the k source, there are future plans to colorise
file permissions. If this happens, I plan to bring those changes
over. If any other enhancements are added, I hope to port those also.
I'd like to display some additional information in the summary line of the listing; I'm currently reviewing what would be most useful.
Contributions and pull-requests are always welcome, as is constructive feedback around code structure, hints, tips, etc.
If you would like to request a feature or report a bug, please add a new issue here and we'll do our best to address them. Please note that this is not a funded project and fixes will be addressed on a best-effort basis.
To contribute directly:
- Fork it (https://github.com/OldhamMade/ll/fork)
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new pull request
We take no responsibility for the use of this tool, or external instances provided by third parties. We strongly recommend you abide by the valid official regulations in your country. Furthermore, we refuse liability for any inappropriate or malicious use of this tool. This tool is provided to you in the spirit of free, open software.
You may view the LICENSE in which this software is provided to you here.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent