Home

Awesome

Собственно что хотелось добавить

Разное

far2l

=======

Cirrus Build Status Coverage Status Coverity Scan Language Grade: C/C++ Packages

far2l tag

Linux fork of FAR Manager v2 (http://farmanager.com/)
Works also on OSX/MacOS and BSD (but latter not tested on regular manner)
BETA VERSION.
Use on your own risk!

Plug-ins that are currently working: NetRocks (SFTP/SCP/FTP/FTPS/SMB/NFS/WebDAV), colorer, multiarc, tmppanel, align, autowrap, drawline, editcase, SimpleIndent, Calculator, Python (optional scripting support)

FreeBSD/MacOS (Cirrus CI): Cirrus

License: GNU/GPLv2

Used code from projects

UI Backends

FAR2L has base UI Backends (see details in build-in help section UI backends):

Mode<br>(UI Backends)TTY<br>(plain far2l)TTY|XTTY|XiGUI
Works:in terminalin terminalin terminalin Desktop<br>environment<br><sub>(X11<br>or Wayland<br>or macOS)<br>via wxWidgets</sub>
Binaries:far2lfar2l<br>far2l_ttyx.brokerfar2l<br>far2l_ttyx.brokerfar2l<br>far2l_gui.so
Dependencies:minimal+ libx11+ libx11, libxi+ wxWidgets, GTK
Keyboard:<sub>Typical terminals:<br>only essential<br>key combinations<br><br>KiTTY (putty fork),<br>kitty (*nix one),<br>iTerm2,<br>Windows Terminal,<br>far2l’s VT: full support</sub><sub>Typical terminals:<br>only essential<br>key combinations<br><br>KiTTY (putty fork),<br>kitty (*nix one),<br>iTerm2,<br>Windows Terminal,<br>far2l’s VT: full support</sub><sub>Typical terminals:<br>most of key<br>combinations under x11;<br>only essential key<br>combinations<br>under Wayland<br><br>KiTTY (putty fork),<br>kitty (*nix one),<br>iTerm2,<br>Windows Terminal,<br>far2l’s VT: full support</sub>All key<br>combinations
Clipboard<br>access:<sub>Typical terminals:<br>via command line<br>tools like xclip<br><br>kitty (*nix one),<br>iTerm2:<br>via OSC52<br><br>Windows Terminal:<br>via OSC52<br>or via command line<br>tools under WSL<br><br>KiTTY (putty fork),<br>far2l’s VT:<br>via far2l extensions</sub><sub>Typical terminals,<br>kitty (*nix one):<br>via x11 interaction<br><br>iTerm2:<br>via OSC52<br><br>Windows Terminal:<br>via OSC52<br>or via command line<br>tools under WSL<br><br>KiTTY (putty fork),<br>far2l’s VT:<br>via far2l extensions</sub><sub>Typical terminals,<br>kitty (*nix one):<br>via x11 interaction<br><br>iTerm2:<br>via OSC52<br><br>Windows Terminal:<br>via OSC52<br>or via command line<br>tools under WSL<br><br>KiTTY (putty fork),<br>far2l’s VT:<br>via far2l extensions</sub>via<br>wxWidgets API<br><br><sub>via command line<br>tools under WSL</sub>
Typical<br>use case:Servers,<br>embedded<sub>Run far2l in<br>favorite terminal<br>but with<br>better UX</sub><sub>Run far2l in<br>favorite terminal<br>but with<br>best UX</sub>Desktop
Mandatory:yesnonono

<sub>Note: When running far2l automatically downgrade if its components are not installed (or system libs are not available): GUI ⇒ TTY|Xi ⇒ TTY|X ⇒ TTY. To force run only specific backend use in command line: for GUI: far2l --notty; for TTY|Xi use in command line: far2l --tty; for TTY|X: far2l --tty --nodetect=xi; for plain TTY: far2l --tty --nodetect=x (see details via far2l --help).</sub>

<sub>Note about use OSC 52 in TTY/TTY|X: to interact with the system clipboard you must not forget to enable OSC 52 in both the FAR2L settings (Options->Interface settings->Use OSC52 to set clipboard data, which shown in the dialog only if far2l run in TTY/TTY|X mode and all other options for clipboard access are unavailable; you can run far2l --tty --nodetect to force not use others clipboard options), and in terminal settings option OSC 52 must be allowed (by default, OSC 52 is disabled in some terminals for security reasons; OSC 52 in many terminals is implemented only for the copy mode, and paste from the terminal goes by bracketed paste mode).</sub>

Installing, Running

Debian/Ubuntu 23.10+ binaries (with TTY X/Xi backends only)

apt-get install far2l

Only under Ubuntu Desktop 23.10 with Wayland run as far2l --nodetect=xi --ee

<sub>Debian has far2 in sid-unstable / 13 trixie-testing / 12 bookworm-backports; Ubuntu from 23.10. Details about versions in the official repositories see in https://packages.debian.org/search?keywords=far2l or https://packages.ubuntu.com/search?keywords=far2l </sub>

<sub>Note: now far2l in official repositories Debian/Ubuntu is only TTY|Xi version with extra dependencies of pair X11-libs. It may be not convenient for some servers. For servers without X and only terminal/ssh access the plain far2l-TTY version is more suitable (binaries or portable see in Community packages & binaries).</sub>

OSX/MacOS binaries

You can install prebuilt package for x86_64 platform via Homebrew Cask, by command:

brew install --cask far2l

You can also manually download and install prebuilt package for x86_64 platform from Releases page: https://github.com/elfmz/far2l/releases

Docker

You can use containers to try far2l without installing anything.

docker build . -l far2l
docker run -it far2l

See also Community packages & binaries

Building, Contributing, Hacking

Required dependencies

Or simply on Debian/Ubuntu:

apt-get install libwxgtk3.0-gtk3-dev libx11-dev libxi-dev libpcre2-dev libxml2-dev libuchardet-dev libssh-dev libssl-dev libsmbclient-dev libnfs-dev libneon27-dev libarchive-dev cmake pkg-config g++ git

A simple sid back port should be as easy as (build your own binary deb from the official source deb package):

# you will find the latest dsc link at http://packages.debian.org/sid/far2l
dget http://deb.debian.org/debian/pool/main/f/far2l/far2l_2.5.0~beta+git20230223+ds-2.dsc
dpkg-source -x *.dsc
cd far2l-*/
debuild
# cd .. and install your self built far2l*.deb

In older distributions: use libwxgtk3.0-dev instead of libwxgtk3.0-gtk3-dev

Clone and Build

git clone https://github.com/elfmz/far2l
cd far2l

mkdir -p _build
cd _build

cmake -DUSEWX=yes -DCMAKE_BUILD_TYPE=Release ..
cmake --build . -j$(nproc --all)

or with ninja (you need ninja-build package installed)

cmake -DUSEWX=yes -DCMAKE_BUILD_TYPE=Release -G Ninja ..
cmake --build .
Additional build configuration options:

To build without WX backend (console version only): change -DUSEWX=yes to -DUSEWX=no also in this case dont need to install libwxgtk*-dev package

To force-disable TTY|X and TTY|Xi backends: add argument -DTTYX=no; to disable only TTY|Xi - add argument -DTTYXI=no

To eliminate libuchardet requirement to reduce far2l dependencies by cost of losing automatic charset detection functionality: add -DUSEUCD=no

To build with Python plugin: add argument -DPYTHON=yes but you must have installed additional packages within yours system: libpython3-dev, libffi-dev, python3-venv.

To control how RAR archives will be handled in multiarc: -DUNRAR=bundled (default) use bundled sources found in multiarc/src/formats/rar/unrar -DUNRAR=lib use libunrar and unrar utility, also build requires libunrar-dev to be installed -DUNRAR=NO dont use special unrar code, rar archives will be handled by libarchive unless its also disabled

There're also options to toggle other plugins build in same way: ALIGN AUTOWRAP CALC COLORER COMPARE DRAWLINE EDITCASE EDITORCOMP FARFTP FILECASE INCSRCH INSIDE MULTIARC NETROCKS SIMPLEINDENT TMPPANEL

OSX/MacOS build

To make custom/recent build use brew or MacPorts.

clang++ -v
One line OSX/MacOS install latest far2l git master via unofficial brew tap
brew install --HEAD yurikoles/yurikoles/far2l

brew install --HEAD yurikoles/yurikoles/far2l --without-wxwidgets
Full OSX/MacOS build from sources (harder):

Some issues can be caused by conflicting dependencies, like having two versions of wxWidgets, so avoid such situation when installing dependencies.

git clone https://github.com/elfmz/far2l
cd far2l

sudo port install cmake pkgconfig wxWidgets-3.2 libssh openssl libxml2 uchardet neon
export PKG_CONFIG_PATH=/opt/local/lib/pkgconfig

brew bundle -v
export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:$(brew --prefix)/opt/openssl/lib/pkgconfig:$(brew --prefix)/opt/libarchive/lib/pkgconfig"

mkdir _build
cd _build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local -DUSEWX=yes -DCMAKE_BUILD_TYPE=Release ..
cmake --build . -j$(sysctl -n hw.logicalcpu)

or with ninja:

mkdir _build
cd _build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local -DUSEWX=yes -DCMAKE_BUILD_TYPE=Release -G Ninja ..
cmake --build .
macOS workaround if far2l in macOS regularly asks permission to folders

After command

 sudo codesign --force --deep --sign - /Applications/far2l.app

it is enough to confirm permission only once.

Details see in issue.

Building on Gentoo (and derivatives)

For absolute minimum you need:

emerge -avn dev-libs/libxml2 app-i18n/uchardet dev-util/cmake

If you want to build far2l with wxGTK support also install it:

emerge -avn x11-libs/wxGTK

Additionally, for NetRocks you will need:

emerge -avn net-libs/neon net-libs/libssh net-fs/libnfs net-fs/samba

After installing, follow Clone and Build section above.

Installing and Building on NixOS

To install system-wide, add the far2l package to your configuration.nix environment.systemPackages list. To run the application on-demand without affecting the system state, execute nix-shell -p far2l --command far2l. These use a package version from your current channel.

The Far2l adaptation for nix is a small file on GitHub, it tells which Git revision from Far2l repo to fetch, with what dependencies to build it, and how to patch its references to other software to make it run in isolated fashion independently from other versions available in the system.

You can build and run far2l package for any revision:

nix-shell -I nixpkgs=https://github.com/<fork>/nixpkgs/archive/<revision-or-branch>.tar.gz -p far2l --command far2l

nix-shell -I nixpkgs=/path/to/nixpkgs -p far2l --command far2l

To advance the package to a new Far2l revision, edit the fetchFromGitHub set attributes rev (revision hash) and sha256 (revision content hash). Important! If you leave the old content hash, the old cached content for that hash might be used without attempting to download the new revision. If you're not expecting the build to break, the easiest would be to make a fork, push the change, and build straight from github.

IDE Setup

You can import the project into your favourite IDE like QtCreator, CodeLite, or any other, which supports cmake or which cmake is able to generate projects for.

<a name="terminals"></a>

Terminals and SSH clients

Supporting extended far2l keyboard shortcuts and clipboard access

Note: to full transfer extended keyboard shortcuts and the clipboard to/from the remote far2l one of the best way to initiate the connection inside local far2l-GUI (see details in build-in help section UI backends).

Useful 3rd-party extras

<a name="community_bins"></a>

Community packages & binaries

They are mainteined by enthusiasts and may be not exact with master: sometimes has extra plugins, sometimes has tweak, etc.

See also in https://github.com/elfmz/far2l/issues/647

Notes on porting and FAR Plugin API changes

Testing

Known issues: