dirsafari
v1.0.5
Published
DirSafari - A terminal application that allows easy listing of files and folders from any directory.
Downloads
13
Maintainers
Readme
dirSafari
This is a simple Node.js terminal application that lists files and folders in a directory. It uses the fs
module from Node.js to read the directory contents and display them in the terminal. The app also utilizes the chalk
library for colorful output.
Requirements
- Node.js (version 12 or higher) should be installed on your machine. You can download it from here.
RUN as NPM Module
$ npm install -g dirsafari
// To EXECUTE DirSafari:
$ ds
OR
$ ds [directory]
OR
$ nodeds [directory]
OR
$ node-ds [directory]
OR
$ dirsafari [directory]
Installation from git repository
- Clone the repository or download the source code.
$ git clone https://github.com/colson0x1/dirsafari.git
- Open a terminal and navigate to the project directory.
$ cd dirsafari
- Give the app executable permission by running the following command:
$ chmod +x app.js
- Install the required dependencies using npm:
$ npm install
- Run the following command with sudo:
$ sudo npm link
This will create a symbolic link for the app.js file, allowing you to run the app from any directory (globally) by typing ds
in the terminal.
Usage
To run the app, use the following command:
$ ds
OR
$ ds [directory]
OR
$ nodeds [directory]
OR
$ node-ds [directory]
OR
$ dirsafari [directory]
Replace [directory]
with the path to the directory you want to list. If no directory is specified, the app will use the current working directory.
The app will display the list of files and folders in the specified directory, with files displayed in orange and folders displayed in blue. Folders will be displayed in bold text.
Example
To list the files and folders in the current directory, run:
$ ds
To list the files and folders in a specific directory, run:
$ ds /path/to/directory
License
This project is licensed under the MIT License. See the LICENSE file for details.
Acknowledgment
I would like to acknowledge the following resources and libraries that were used in the development of this app: