Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/roberthawdon/dfshow

An open source implementation of some of the applications from Larry Kroeker's DF-EDIT
https://github.com/roberthawdon/dfshow

bsd cli command-line file-manager linux macos terminal-based unix

Last synced: about 2 months ago
JSON representation

An open source implementation of some of the applications from Larry Kroeker's DF-EDIT

Awesome Lists containing this project

README

        

DF-SHOW
=======

|Maintenance yes| |GPLv3 license| |Documentation| |Contributor Covenant|

.. |Maintenance yes| image:: https://img.shields.io/badge/Maintained%3F-yes-green.svg
:target: https://github.com/roberthawdon/dfshow/graphs/commit-activity

.. |GPLv3 license| image:: https://img.shields.io/badge/License-GPLv3-blue.svg
:target: https://raw.github.com/roberthawdon/dfshow/master/LICENSE

.. |Documentation| image:: https://readthedocs.org/projects/dfshow/badge/?version=latest
:target: https://dfshow.readthedocs.io/en/latest/?badge=latest

.. |Contributor Covenant| image:: https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg
:target: CODE_OF_CONDUCT.md

:Author: Robert Ian Hawdon ([email protected])
:Source: https://github.com/roberthawdon/dfshow
:Version: beta

**DF-SHOW (Directory File Show) is a Unix-like rewrite of some of the applications from Larry Kroeker's DF-EDIT (Directory File Editor) for MS-DOS and PC-DOS systems, based on the Version 2.3d release from 1986.**

* `Bug Tracker`_

.. _`Bug Tracker`: https://github.com/roberthawdon/dfshow/issues

Introduction
------------

The show application lets users view the names of files and directories on a disk with information about the files. Files can be copied, moved, viewed, and edited (in your system's default editor). The application is run using the ``show`` command. The output is similar to the ``ls`` command. A file view is also included which can be invoked using the ``sf`` command.

Features
--------

* **List files.** DF-SHOW's primary function is to display a list of files on a system, in an interactive display allowing users' to browse up and down large lists of files in a directory.
* **View files.** The ability to quickly peek into text files makes DF-SHOW a powerful tool for power users, this function uses the default pager defined in the user's system environment or the included ``sf`` application.
* **Edit files.** Whilst DF-SHOW doesn't come with a text editor like DF-EDIT (for the reason there are many good, well established text editors already available), it can launch the user's default text editor for any given selected file.
* **Copy files.** DF-SHOW can copy files to another destination.
* **Create links.** Both Symbolic and Hard links can be created using DF-SHOW.
* **Rename files.** Users' can move files to a different file name.
* **Delete files.** DF-SHOW also removes files at the user's request.
* **Create directories.** Users' are also able to create new directories from within the DF-SHOW interface.
* **Touch files.** Timestamps on files can be changed, as well as the creation of new blank files.
* **Update permissions.** Owners, groups, and permissions can be set within the application. SELinux security contexts can also be modified on supported systems.
* **Hunt within files.** Find files in a directory containing a string.
* **Execute applications.** Files with execution permissions can be launched from withing DF-SHOW.

Installing DF-SHOW
------------------

**Arch**

Releases of DF-SHOW are available in the AUR

.. code-block:: bash

curl -L https://aur.archlinux.org/cgit/aur.git/snapshot/dfshow.tar.gz | tar xz
cd dfshow
makepkg -srci

The latest cutting edge versions from the ``master`` branch are also available in the AUR

.. code-block:: bash

curl -L https://aur.archlinux.org/cgit/aur.git/snapshot/dfshow-git.tar.gz | tar xz
cd dfshow-git
makepkg -srci

**Ubuntu**

Run the following to install DF-SHOW from the offical PPA

.. code-block:: bash

sudo add-apt-repository ppa:ian-hawdon/dfshow
sudo apt-get update
sudo apt-get install dfshow

**RPM Based Distributions**

Packages are available from the `Fedora Copr`_ build service:

If you’re using a version of Linux with dnf:

.. code-block:: bash

sudo dnf copr enable roberthawdon/DF-SHOW

you need to have ``dnf-plugins-core`` installed

.. code-block:: bash

sudo dnf install dfshow

If you have older distribution:

.. code-block:: bash

sudo yum copr enable roberthawdon/DF-SHOW

you need to have ``yum-plugin-copr`` installed

.. code-block:: bash

sudo yum install dfshow

For more information, please see the `roberthawdon/DF-SHOW`_ repository.

.. _`Fedora Copr`: https://copr.fedoraproject.org/coprs/

.. _`roberthawdon/DF-SHOW`: https://copr.fedorainfracloud.org/coprs/roberthawdon/DF-SHOW/

**macOS**

Versions of DF-SHOW for macOS are provided via Homebrew. Homebrew is available for macOS versions 10.6 (Snow Leopard) and above. Any version of macOS supporting Homebrew can be used to install DF-SHOW.

Please visit the `Homebrew homepage`_ for instructions for installing Homebrew on your Mac.

.. _`Homebrew homepage`: https://brew.sh/

To install DF-SHOW via Homebrew, run the following in your terminal:

.. code-block:: bash

brew tap roberthawdon/dfshow
brew install dfshow

Building from Git
-----------------

Download the project and prepare sources with

.. code-block:: bash

git clone https://github.com/roberthawdon/dfshow
cd dfshow
./bootstrap
./configure

On some BSD systems, you may need to pass extra parameters to configure and build DF-SHOW:

.. code-block:: bash

./configure LDFLAGS="-L/usr/local/lib" CFLAGS="-I/usr/local/include"

On macOS with Homebrew, the following needs to be passed when configuring:

.. code-block:: bash

./configure LDFLAGS="-L$(brew --prefix)/lib" CFLAGS="-I$(brew --prefix)/include" CC=clang

Build DF-SHOW with

.. code-block:: bash

make

Install DF-SHOW

.. code-block:: bash

sudo make install

Running Show
------------

The show directory utility is invoked with the following command:

show

The parameter can by any directory the current user has access to on the system, similar to the ``ls`` command. Using ``/`` will take the user to the root directory of the system.

If the show directory utility is invoked without specifing a directory, then the current directory is displayed.

Running SF
----------

The show file utility is invoked with the following command:

sf

The parameter can be any file the current user has access to on the system. If the show file utility is invoked without specifing a file, then the user is prompted to load a file within the application.

Donations
---------

To support this project, you can make a donation to its current maintainer:

**PayPal**

|PayPal|

Donations are also greatly appreciated via the following crypto currencies:

.. raw:: html



Bitcoin


bc1qxgy074cwdsvekg98fkqzju99kgyxzcyuqgqm6p






Ethereum


0xF282bccB7FEdA4BaCc84F75478dA84D61980DDab






Loopring (Layers 1 and 2)


0xF282bccB7FEdA4BaCc84F75478dA84D61980DDab






Immutable X (Layers 1 and 2)


0xF282bccB7FEdA4BaCc84F75478dA84D61980DDab






Bitcoin Cash


qpmmdn9xvurp8dt2j4sadnzulun8jvjsjv5ymt2uk4






Dogecoin


D7jSRBKo9vBmwAjKZ6wZvZ8AGPDw4u9yoY






Basic Attention Token


0xF282bccB7FEdA4BaCc84F75478dA84D61980DDab






Polygon (MATIC)


0xF282bccB7FEdA4BaCc84F75478dA84D61980DDab






Cardano


addr1q8g9tdafpscdzhpfl7w94d9mlrmjzsx30wu0ag0f7r9u8ekyy2s96z0fymwaymh537zk3geedx89u54ac6em4lsnp8esyfefhg






Litecoin


ltc1q00qzqhutjnlgarvpk3x6vq3yguntt2dm57k28q






Ripple (XRP)


raozHiwzd2mEQSWMTMefoBdAAuiw2okzCE






Stellar


GCOIIDGU5BFVSPPCYPEPBVBSWZL7NYR2MJWVMJKWELCNFHRHLFFAL3G5






VeChain


0x45D9C3c345901D445B72eCd70852b6f06D8945D3






Akash


akash1v3rk372avjksx8v2tvj5g83686k24les67rjnt






Akoin


GCOIIDGU5BFVSPPCYPEPBVBSWZL7NYR2MJWVMJKWELCNFHRHLFFAL3G5






USD Coin


0xF282bccB7FEdA4BaCc84F75478dA84D61980DDab






Tether


0xF282bccB7FEdA4BaCc84F75478dA84D61980DDab



.. |PayPal| image:: https://user-images.githubusercontent.com/4301139/91666536-6fb15080-eaf5-11ea-974b-f0eb997615b4.gif
:target: https://paypal.me/RIHawdon

Screenshots
-----------

**Show**

.. image:: https://user-images.githubusercontent.com/4301139/52901919-bd12e900-3201-11e9-9114-0ae23a6f9746.png
:alt: Directory Viewer

**SF - Show File**

.. image:: https://user-images.githubusercontent.com/4301139/56430876-c121bc80-62bf-11e9-9ac3-d892d8f37acb.png
:alt: Show File

**Colors (Built into Show)**

.. image:: https://user-images.githubusercontent.com/4301139/56430881-c2eb8000-62bf-11e9-978b-3fda6f8cb0f3.png
:alt: Colors