Menu

Tree [758f3e] main /
 History

HTTPS access


File Date Author Commit
 .github 2025-01-29 Jian Z'car Esteban Jian Z'car Esteban [21c3af] Update FUNDING.yml
 bin 2025-01-31 JianZcar JianZcar [758f3e] Added an option to turn off AUTO_GIT, ICON is n...
 CODE_OF_CONDUCT.md 2025-01-27 Jian Z'car Esteban Jian Z'car Esteban [816e4f] Create CODE_OF_CONDUCT.md
 CONTRIBUTING.md 2025-01-27 Jian Z'car Esteban Jian Z'car Esteban [4c77fb] Create CONTRIBUTING.md
 LICENSE 2025-01-18 Jian Z'car Esteban Jian Z'car Esteban [3093c1] Create LICENSE
 README.md 2025-01-30 Jian Z'car Esteban Jian Z'car Esteban [03dbb1] Update README.md

Read Me

📙FuzPad!

FuzPad is a minimalistic note management solution. Powered by ⚡junegunn/fzf

Sample Image Sample Image Sample Image Sample Image

Star History Chart

Features

  • New: Create a new note with the current date and time as the filename.
  • Open: Open an existing note.
  • Search: Search within notes for specific content.
  • Delete: Delete selected notes.
  • Version control: Automatically commits changes to your notes.

Planned Features

  • Tags: tagging system
  • CLI: create a cli that allows piping, etc.

Goals

  • Provide a straightforward and minimalistic note management solution using a Bash script.
  • Ensure ease of use with intuitive commands and interface.

Requirements

  • Bash
  • Git (optional)
  • fzf (fuzzy finder)
  • bat (for enhanced preview)
  • Your preferred text editor (default is nano)

Installation

Using Homebrew

brew install JianZcar/packages/fuzpad

Using curl

curl -s https://gist.githubusercontent.com/JianZcar/df050e108b462e469f413f0eec229143/raw | bash

Manual Installation

  1. Clone the repository:
git clone https://github.com/JianZcar/FuzPad.git
cd notes-bash
  1. Make the script executable:
chmod +x bin/notes
  1. Run the script:
./bin/notes

Configuration

  • Default Directory: Change the default directory for notes by modifying the FUZPAD_DIR variable in the script or by setting it in your ~/.bashrc file:
    sh export FUZPAD_DIR="$HOME/Documents/.notes"

  • Text Editor: Change the text editor by modifying the EDITOR variable in the script or by setting it in your ~/.bashrc file:
    sh export EDITOR="nano"

  • Text Format: Change the text format by modifying the TEXT_FORMAT variable in the script or by setting it in your ~/.bashrc file:
    sh export FUZPAD_TEXT_FORMAT="txt"

  • Date Time Format: Change the date and time format used for note filenames by modifying the DATE_TIME_FORMAT variable in the script or by setting it in your ~/.bashrc file:
    sh export FUZPAD_DATE_TIME_FORMAT="%Y-%m-%d-%H-%M-%S"

  • BAT Theme: Change the theme used by bat for previewing notes by modifying the BAT_THEME variable in the script or by setting it in your ~/.bashrc file:
    sh export FUZPAD_BAT_THEME="OneHalfLight"

  • Reverse List: Set to true to reverse the order of the list when opening or deleting notes by modifying the REVERSE_LIST variable in the script or by setting it in your ~/.bashrc file:
    sh export FUZPAD_REVERSE_LIST="false"

  • Sort Format: Change the sorting format for listing notes (T@ for creation date, Y for modified date) by modifying the SORT_FORMAT variable in the script or by setting it in your ~/.bashrc file:
    sh export FUZPAD_SORT_FORMAT="T@"

  • Preview Size: Change the size of the preview window for fzf by modifying the PREVIEW_SIZE variable in the script or by setting it in your ~/.bashrc file:
    sh export FUZPAD_PREVIEW_SIZE="70%"

  • Start Line Search Preview: Set the starting line number for the search preview by modifying the START_LINE_SEARCH_PREVIEW variable in the script or by setting it in your ~/.bashrc file:
    sh export FUZPAD_START_LINE_SEARCH_PREVIEW="5"

  • End Line Search Preview: Set the ending line number for the search preview by modifying the END_LINE_SEARCH_PREVIEW variable in the script or by setting it in your ~/.bashrc file:
    sh export FUZPAD_END_LINE_SEARCH_PREVIEW="9999"

After adding the necessary variables to your ~/.bashrc file, remember to source it to apply the changes:

source ~/.bashrc

Updates

  • Major Updates: No clear dates at the moment.
  • Minor Updates: Released every Monday.
  • Patch Updates: Released as soon as possible.

Contributing

We welcome contributions from the community! Please refer to the Contributing Guidelines for more details on how to get started.

Feel free to fork the repository and submit pull requests. Contributions are welcome!

License

This project is licensed under the terms of the GNU General Public License v3.0. For more details, see the LICENSE file in the repository.

Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.