Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nightroman/FarNet
Far Manager framework for .NET modules and scripts in PowerShell, F#, JavaScript.
https://github.com/nightroman/FarNet
c-sharp dot-net f-sharp far-manager javascript plugin powershell
Last synced: 3 months ago
JSON representation
Far Manager framework for .NET modules and scripts in PowerShell, F#, JavaScript.
- Host: GitHub
- URL: https://github.com/nightroman/FarNet
- Owner: nightroman
- License: bsd-3-clause
- Created: 2015-03-15T01:24:48.000Z (almost 10 years ago)
- Default Branch: main
- Last Pushed: 2024-05-19T05:34:29.000Z (8 months ago)
- Last Synced: 2024-05-19T06:29:07.400Z (8 months ago)
- Topics: c-sharp, dot-net, f-sharp, far-manager, javascript, plugin, powershell
- Language: C#
- Homepage: https://github.com/nightroman/FarNet/wiki
- Size: 8.59 MB
- Stars: 129
- Watchers: 16
- Forks: 18
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# FarNet
Far Manager platform for .NET modules and scripts in PowerShell, F#, JavaScript
- [Wiki](https://github.com/nightroman/FarNet/wiki) - framework, modules, libraries
- [Issues](https://github.com/nightroman/FarNet/issues) - bug reports and problems
- [Discussions](https://github.com/nightroman/FarNet/discussions) - questions and ideas
## Prerequisites
**.NET 8.0**
Download and install [.NET 8.0 SDK or runtime](https://aka.ms/dotnet/download), **x64 or x86 depending on Far Manager**.\
SDK is needed for developing FarNet modules but recommended in any case.
Check for existing installations by these commands:
dotnet --version
dotnet --info
**Visual C++ Redistributable**
Look at the installed programs and find entries like:
- Microsoft Visual C++ 2015-2022 Redistributable (x64)
- Microsoft Visual C++ 2015-2022 Redistributable (x86)
If they are missing, then install the required.
Links are not provided, they keep changing.
**Far Manager**
Choose the required from [downloads](https://www.farmanager.com/download.php?l=en).\
Normally the stable build is recommended.
## Install using PowerShell
This way avoids manual steps and allows updates later.
Close Far Manager and start the PowerShell console.
Change to the Far Manager directory
```powershell
Set-Location "C:\Program Files\Far Manager"
```
Import Far package functions
```powershell
iex (iwr https://raw.githubusercontent.com/nightroman/FarNet/main/web.ps1)
```
If it fails on older systems, try
```powershell
[Net.ServicePointManager]::SecurityProtocol = "Tls11,Tls12,$([Net.ServicePointManager]::SecurityProtocol)"
iex (New-Object Net.WebClient).DownloadString('https://raw.githubusercontent.com/nightroman/FarNet/main/web.ps1')
```
Install FarNet
```powershell
Install-FarPackage FarNet
```
Install modules
```powershell
Install-FarPackage FarNet.CopyColor
Install-FarPackage FarNet.Drawer
Install-FarPackage FarNet.EditorKit
Install-FarPackage FarNet.Explore
Install-FarPackage FarNet.FolderChart
Install-FarPackage FarNet.FSharpFar
Install-FarPackage FarNet.GitKit
Install-FarPackage FarNet.JavaScriptFar
Install-FarPackage FarNet.PowerShellFar
Install-FarPackage FarNet.RedisKit
Install-FarPackage FarNet.RightControl
Install-FarPackage FarNet.RightWords
Install-FarPackage FarNet.Vessel
```
Install libraries
```powershell
Install-FarPackage FarNet.FSharp.Charting
Install-FarPackage FarNet.FSharp.Data
Install-FarPackage FarNet.FSharp.PowerShell
Install-FarPackage FarNet.FSharp.Unquote
Install-FarPackage FarNet.Redis
Install-FarPackage FarNet.ScottPlot
Install-FarPackage FarNet.Stateless
Install-FarPackage FarNet.SQLite
```
You may start Far Manager after this.
Modules are installed in `%FARHOME%\FarNet\Modules`.
Libraries are installed in `%FARHOME%\FarNet\Lib`.
## Update using PowerShell
FarNet packages installed by `Install-FarPackage` may be updated in the same way.
Close Far Manager, open PowerShell console, and invoke
```powershell
Set-Location "C:\Program Files\Far Manager"
iex (iwr https://raw.githubusercontent.com/nightroman/FarNet/main/web.ps1)
```
To update all packages, use
```powershell
Update-FarPackage
```
To update one package, use `Install-FarPackage`
```powershell
Install-FarPackage FarNet.PowerShellFar
```
To remove one package, use `Uninstall-FarPackage`
```powershell
Uninstall-FarPackage FarNet.PowerShellFar
```
## Install packages manually
Given a package `Bar`, download it as
The downloaded file name is `Bar..nupkg`. This is a zip archive, you
may save it with the zip extension for easier unpacking.
All needed files are in the folder `tools`. This folder contains `FarHome` and
may contain `FarHome.x64` and `FarHome.x86` folders.
Copy `FarHome` items to the Far Manager home directory preserving the folder
structure. For example, by this command in Far Manager:
```cmd
robocopy FarHome "%FARHOME%" /s
```
If `FarHome.x64` and `FarHome.x86` exist then, depending on x64 or x86, copy
items of `FarHome.x64` or `FarHome.x86` to Far Manager:
```cmd
robocopy FarHome.x64 "%FARHOME%" /s
robocopy FarHome.x86 "%FARHOME%" /s
```