description | Linux port of FAR v2 |
homepage URL | https://github.com/elfmz/far2l |
repository URL | https://github.com/elfmz/far2l.git |
owner | root@yurikoles.com |
last change | Tue, 4 Jun 2024 09:33:10 +0000 (4 12:33 +0300) |
last refresh | Sat, 8 Jun 2024 05:19:06 +0000 (8 07:19 +0200) |
mirror URL | git://repo.or.cz/far2l.git |
https://repo.or.cz/far2l.git | |
ssh://git@repo.or.cz/far2l.git | |
bundle info | far2l.git downloadable bundles |
content tags |
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)
apt-get install far2l
Under Ubuntu Desktop 23.10 run as
far2l --nodetect=xi --ee
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>
You can use containers to try far2l
without installing anything.
docker build . -l far2l
docker run -it far2l
See also Community packages & binaries
apt-get install libwxgtk3.0-gtk3-dev libx11-dev libxi-dev libpcre3-dev libxerces-c-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 libpcre2-dev and libwxgtk3.0-dev instead of libpcre3-dev and libwxgtk3.0-gtk3-dev
git clone https://github.com/elfmz/far2l
cd far2l
git checkout v_2.#.#
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 .
If above commands finished without errors - you may also install far2l, sudo cmake --install .
Also it's possible to create far2l_2.X.X_ARCH.deb or ...tar.gz packages in _build
directory by running cmake --build . --target package
command.
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
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
To make custom/recent build use brew or MacPorts.
AppleClang 8.0.0.x
or newer. Check your version, and install/update Xcode if necessary.clang++ -v
brew install --HEAD yurikoles/yurikoles/far2l
brew install --HEAD yurikoles/yurikoles/far2l --without-wxwidgets
--with-python@3.10
to the one of two above commands.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 xercesc3 libfmt 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 .
cpack
command.
Note that this step sometimes fails and may succeed from not very first attempt.
Its recommended not to do anything on machine while cpack is in progress.
After .dmg successfully created, you may install it by running open ...path/to/created/far2l-*.dmg
After command
sudo codesign --force --deep --sign - /Applications/far2l.app
it is enough to confirm permission only once.
Details see in issue
.
For absolute minimum you need:
emerge -avn dev-libs/xerces-c 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.
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:
NixOS/nixpkgs
repo, or your own fork and branch):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.
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.
_build
; you can change in .vscode/settings.json
)Supporting extended far2l keyboard shortcuts and clipboard access
Windows Terminal (TTY|w backend: keys by win32-input-mode; turn on OSC 52 for clipboard support; has mouse bug: https://github.com/microsoft/terminal/issues/15083 )
Original Putty does not correctly send some keyboard shortcuts. Please use putty forks with special far2l TTY extensions support (fluent keypresses, clipboard sharing etc):
Tool to import color schemes from windows FAR manager 2 .reg format: https://github.com/unxed/far2ltricks/blob/main/misc/far2l_import.pl
Community wiki & tips (in Russian; unofficial): https://github.com/akruphi/far2l/wiki
They are mainteined by enthusiasts and may be not exact with master: sometimes has extra plugins, sometimes has tweak, etc.
Flatpak: https://github.com/spvkgn/far2l-flatpak (access only to part of real filesystem via sandbox)
See also in https://github.com/elfmz/far2l/issues/647
7 weeks ago | v_2.6.1_hotfix1 | commitlog | ||
7 weeks ago | v_2.6.1 | commitlog | ||
3 months ago | v_2.6.0 | 2.6.0 | tag | commitlog |
7 months ago | v_2.5.3 | commitlog | ||
9 months ago | v_2.5.2 | commitlog | ||
12 months ago | v_2.5.1 | commitlog | ||
16 months ago | v_2.5.0 | commitlog | ||
20 months ago | v_2.4.1 | commitlog | ||
2 years ago | v_2.4.0 | commitlog | ||
2 years ago | v_2.3.2 | commitlog | ||
2 years ago | v2021-12-04_alpha | commitlog | ||
2 years ago | v2021-09-21_alpha | commitlog | ||
2 years ago | v2021-06-30_alpha | commitlog | ||
3 years ago | v2021-04-26_alpha | commitlog | ||
3 years ago | v2021-04-19_alpha | v2021-04-19_alpha | tag | commitlog |
3 years ago | alpha-17sep20 | alpha 17 september 2020 | tag | commitlog |
... |
3 days ago | master | logtree |
7 weeks ago | v_2.6.1_hotfix | logtree |
20 months ago | debug-1361 | logtree |
3 years ago | iconv | logtree |