Skip to content

Previewer is a file browser for linux terminal written in python with curses, it is meant to easily preview files, with a simple folder tree list as navigation system

License

Notifications You must be signed in to change notification settings

mgustran/previewer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Previewer

Previewer is a file browser for linux terminal written in python with curses.
It is meant to easily preview files, with a folder tree list as navigation system.
Designed to work in non-desktop environments, tty, ssh connections, devices with small displays...

Features

  • Navigate filesystem through expandable Folder Tree
  • Preview files with syntax highlighting for almost any coding language
  • Jump to vim / nano / micro editor with key B / N / M

Requirements

  • Linux Terminal
  • Python 3 (only for installation method 2)

Installation

  • Method 1 - Install script (recommended) : Deprecated: migrating to pyinstaller
    git clone https://github.com/mgustran/previewer.git
    cd previewer
    bash install.sh

  • Method 2 - ZipApp & Alias :
    git clone https://github.com/mgustran/previewer.git
    cd previewer
    bash install-alias.sh
    * Can use --fast to skip dependency install, be sure to run it without 1st time

Usage

  • preview Opens current working dir
  • preview <path> Opens folder/file passed as argument

Licences

  • GNU GPL, see LICENCE file
  • Using a modified version of culour (GNU GPL) to work with pygments library


Thanks to Clay McLeod for an excellent example to start learning python curses

About

Previewer is a file browser for linux terminal written in python with curses, it is meant to easily preview files, with a simple folder tree list as navigation system

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published