FarNet.Vessel 5.0.1

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
There is a newer version of this package available.
See the version list below for details. 
dotnet add package FarNet.Vessel --version 5.0.1
NuGet\Install-Package FarNet.Vessel -Version 5.0.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="FarNet.Vessel" Version="5.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add FarNet.Vessel --version 5.0.1
#r "nuget: FarNet.Vessel, 5.0.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install FarNet.Vessel as a Cake Addin
#addin nuget:?package=FarNet.Vessel&version=5.0.1

// Install FarNet.Vessel as a Cake Tool
#tool nuget:?package=FarNet.Vessel&version=5.0.1

Vessel

Vessel is the FarNet module for Far Manager.
It provides enhanced history of files, folders, commands.

Module

UI help

Project

Installation

How to install and update FarNet and modules:
https://github.com/nightroman/FarNet#readme

Technical details

Wiki: https://github.com/nightroman/FarNet/wiki/Vessel

Description

Contents

Features

  • Enhanced history of files, folders, commands
  • Ready for typing incremental filter
  • See also history lists help (F1)

Vessel history lists are Far Manager histories enhanced by the tracked items. Tracked items are usually created automatically on picking not recent items. Tracked items are stored in automatically maintained log files.

Vessel lists order items by groups and times. Group 0 includes recently used items, tracked and history. Group 1 includes only tracked used items. Group 2 includes tracked aged and not recently used history items.

Background maintenance of logs starts periodically after picking items from lists. Manual updating from menu or lists is available but not necessary.

Tracked items log files:

  • Commands: %FARLOCALPROFILE%\FarNet\Vessel\VesselCommands.txt
  • Folders: %FARLOCALPROFILE%\FarNet\Vessel\VesselFolders.txt
  • Files: %FARLOCALPROFILE%\FarNet\Vessel\VesselHistory.txt

Settings

Contents

Module settings: [F11] \ FarNet \ Settings \ Vessel

  • MaximumDayCount

    Maximum number of days for keeping idle tracked items as used. Older items remain tracked but become aged. The default is 42 days.

  • MaximumFileAge

    Maximum age of tracked aged items. The default is 365 days.

  • MaximumFileCount

    Maximum number of tracked items. The default is 1000 items.

  • MaximumFileCountFromFar

    Maximum number of items taken from far history. The default is 1000 items.

  • MinimumRecentFileCount

    Tells to treat the specified number of items as recent even if they are older than Limit0 hours. This avoids disappearance of all recent items after long breaks. The default is 10.

  • Limit0

    The time span in hours which defines recently used items. Items are sorted by times, like in the usual history. The default is 2 hours.

  • ChoiceLog

    The optional log file of choices in TSV format. Only choices of not recent items are logged. Recent items always have zero gain. Use this log to see how Vessel works.

    • Gain ~ time sorted index minus choice index
    • Rank ~ choice index in the ranked list
    • Age ~ hours since the last use
    • Mode ~ File, Folder, Command
    • Path ~ item path or text

Contents

The menu is opened from almost any area: [F11] \ Vessel

Files

Opens the file history list. See File history

Folders

Opens the folders history list. See Folder history

Commands

Opens the command history list. See Command history

Update logs

Removes missing paths and excessive records from logs. Marks used tracked items as aged when they get old. The results are printed to the console.

File history

Contents

The file history list is opened by the menu Files. Tracked items are shown with ticks.

Keys and actions:

  • [Enter], [F4]

    Opens the file in the editor.

  • [CtrlF4]

    Opens the file in the modal editor.

  • [CtrlEnter]

    Navigates to the file in the panel.

  • [ShiftEnter]

    Opens the file in the editor and shows the list again.

  • [F3]

    Opens the file in the viewer.

  • [CtrlF3]

    Opens the file in the modal viewer.

  • [F12]

    Toggles filter by the current directory.

  • [CtrlR]

    Updates the history log. It removes missing paths and excessive records.

  • [Del]

    Stops or starts the current item tracking.

  • [ShiftDel] (Panels, Editor, Viewer)

    Removes the current item from log and history.

  • List menu keys

Folder history

Contents

The folder list is opened by the menu Folders. Tracked items are shown with ticks.

Keys and actions:

  • [Enter]

    Opens the folder in the current panel.

  • [CtrlEnter]

    Navigates to the folder in the panel.

  • [ShiftEnter]

    Opens the folder in the current panel in a new window. The passive panel is set to the current active path.

  • [F12]

    Toggles filter by the current directory.

  • [CtrlR]

    Updates the folders log. It removes missing paths and excessive records.

  • [Del]

    Stops or starts the current item tracking.

  • [ShiftDel] (Panels)

    Removes the current item from log and history.

  • List menu keys

Command history

Contents

The command list is opened by the menu Commands. Tracked items are shown with ticks.

Keys and actions:

  • [Enter]

    Puts the command to the command line and invokes it.

  • [CtrlEnter]

    Puts the command to the command line without invoking.

  • [CtrlR]

    Updates the command log. It removes excessive records.

  • [Del]

    Stops or starts the current item tracking.

  • [ShiftDel] (Panels)

    Removes the current item from log and history.

  • List menu keys

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
6.0.0 281 11/19/2023
5.0.2 554 1/1/2023
5.0.1 277 12/28/2022
5.0.0 345 11/18/2022
4.0.1 415 8/27/2022
4.0.0 464 7/19/2022
3.0.3 432 7/8/2022
3.0.2 426 7/6/2022
3.0.0 417 7/5/2022
2.7.1 434 6/29/2022
2.7.0 447 6/23/2022
2.6.2 394 6/7/2022
2.6.1 324 12/27/2021
2.6.0 968 12/3/2021
2.5.7 283 11/28/2021
2.5.6 402 1/23/2021
2.5.5 403 1/12/2021
2.5.4 352 1/5/2021
2.5.3 381 1/5/2021
2.5.2 432 1/3/2021
2.5.1 445 12/27/2020
2.5.0 415 10/27/2020
2.4.1 470 5/13/2020
2.4.0 474 5/11/2020
2.3.3 498 5/8/2020
2.3.2 605 10/23/2019
2.3.1 539 10/20/2019
2.3.0 512 10/17/2019
2.2.1 530 9/4/2019
2.2.0 785 11/27/2018
2.1.2 770 11/3/2018
2.1.1 810 10/14/2018
2.1.0 1,048 7/22/2017
2.0.6 1,325 5/16/2015
2.0.5 1,723 3/28/2014
2.0.4 1,155 3/10/2014

https://github.com/nightroman/FarNet/blob/master/Vessel/History.txt