Skip to content

zertyuiop/FarNet

 
 

Repository files navigation

FarNet

Far Manager platform for .NET modules, Windows PowerShell, and F#.
FarNet/wiki describes the framework, modules, and available packages.

Prerequisites

.NET Framework 4.5 or above

The version of .NET Framework (4.5+) installed on a machine is listed in the registry at:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full

If this key is missing, then install .NET Framework 4.5 or above.
Some modules may require specific minimum versions.

Visual C++ Redistributable

Look at the installed programs and find entries like:

  • Microsoft Visual C++ 2015-2019 Redistributable (x64)
  • Microsoft Visual C++ 2015-2019 Redistributable (x86)

If they are missing, then install the required.

Far Manager

Choose the required from downloads.
Normally the stable build is recommended.

Install using PowerShell

This way avoids several manual steps and possible mistakes. And it allows automated updates later.

Close Far Manager and start the PowerShell console

powershell

Change to the Far Manager directory

cd "C:\Program Files\Far Manager"

Invoke the preliminary command

iex (New-Object Net.WebClient).DownloadString('https://raw.githubusercontent.com/zertyuiop/FarNet/master/web.ps1')

If it fails on older systems, run this first

[Net.ServicePointManager]::SecurityProtocol = "Tls11,Tls12,$([Net.ServicePointManager]::SecurityProtocol)"

Install FarNet

Install-FarPackage FarNet

Install modules, for example

Install-FarPackage FarNet.PowerShellFar

You may start Far Manager after this.

Take a look at the installed files, there may be manuals, samples, and etc. The folder FarNet contains About-FarNet.htm и FarNetApi.chm. Modules normally have their files in folders like FarNet\Modules\ModuleName.

Update using PowerShell

FarNet and modules installed by Install-FarPackage may be updated in the same way.

Close Far Manager and start the PowerShell console

powershell

Change to the Far Manager directory

cd "C:\Program Files\Far Manager"

Invoke the preliminary command

iex (New-Object Net.WebClient).DownloadString('https://raw.githubusercontent.com/nightroman/FarNet/master/web.ps1')

To update all packages, invoke

Update-FarPackage

To update one package, use Install-FarPackage, for example

Install-FarPackage FarNet.PowerShellFar

To remove one package, use Uninstall-FarPackage, for example

Uninstall-FarPackage FarNet.PowerShellFar

Install FarNet manually

Download the FarNet package as

https://nuget.org/api/v2/package/FarNet

The file is called FarNet.<version>.nupkg. This is a zip archive, you can save it with the zip extension for easier unpacking.

All needed files are in the folder "tools". This folder contains "FarHome", "FarHome.x64" and "FarHome.x86" folders.

Copy items of "FarHome" to Far Manager preserving the folder structure. Depending on Far Manager, x64 or x86, copy items of "FarHome.x64" or "FarHome.x86" to Far Manager as well.

Install modules manually

Steps may depend on a module. But the common rule for any module Bar is: in Far Manager\FarNet\Modules there is a folder Bar which contains the module files. One of these files is the assembly Bar.dll.

Download the NuGet package Bar as

https://nuget.org/api/v2/package/Bar

The file is called Bar.<version>.nupkg. This is a zip archive, you can save it with the zip extension for easier unpacking. All needed files are in the folder "tools". In order to install the module, copy items of the folder "FarHome" to Far Manager preserving the folder structure. If there are "FarHome.x64" and "FarHome.x86" folders, copy required items as well.

About

Far Manager framework for .NET, PowerShell, F#.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 59.3%
  • PowerShell 16.2%
  • C++ 16.1%
  • F# 8.0%
  • Other 0.4%