zel.el --- Access frecent files easily

zel tracks the most used files, based on frecency. Zel is basically a port of z in Emacs Lisp.

The list of frecent files underlies two concepts:

The files are not only ranked on how recent they have been visited, but also how frequent they have been visited. A file that has been visited multiple times last week gets a higher score as file visited once yesterday. Outliers should not compromise the frecent list.
Entries in the frecent list undergo aging. If the age of a entry falls under a threshold it gets removed from the 'frecent' list.

Installation

MELPA

If you installed from MELPA, you're done.

use-package

(use-package zel
  :ensure t
  :demand t
  :bind (("C-x C-r" . zel-find-file-frecent))
  :config (zel-install))

Manual

Install these required packages:

frecency

Then put zel.el in your load-path, and put this in your init file:

(require 'zel)

Usage

Run (zel-install)
Bind zel-find-file-frecent to a key, e.g. (global-set-key (kbd "C-x C-r") #'zel-find-file-frecent)
Visit some files to build up the database
Profit.

As default the frecent history is saved to zel-history-file. Run M-x customize-group RET zel for more customization options.

Besides zel-find-file-frecent, that lets you select a file with completing-read and switches to it, there is also the command zel-diplay-rankings that shows all entries of the frecent list along with their score.

If you'd like to stop building up the frecent list then run zel-uninstall to deregister zel from all hooks.

Credits

License

See LICENSE

rudolfochrist/zel