0xdeadbeer/vis
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
TUI program for managing your calendar through a grid-like interace.
17 Commits 1 Branch 0 Tags 103 KiB
C++ 56.3%
C 39%
CMake 4.7%
main
Go to file
osamu-kj fcf6a47a12 Vis: Update README.md
2023-05-20 02:33:06 +02:00
preview Vis: Remove unnecessary code + Update README.md 2023-05-20 02:08:12 +02:00
src Shortcuts: Add copy-paste shortcuts 2023-05-20 02:31:33 +02:00
.gitignore Initialize the project with basic code 2023-04-18 23:33:40 +02:00
CMakeLists.txt CMake: Add necessary install rules for 'make install' 2023-05-14 14:22:27 +02:00
LICENSE Initial commit 2023-04-18 19:42:18 +02:00
README.md Vis: Update README.md 2023-05-20 02:33:06 +02:00
RESOURCES.md Resizing: re-draw at terminal resize 2023-04-22 11:42:54 +02:00

README.md

Vi Scheduler

Vi Scheduler (VIS) is a lightweight tool that brings a Vim-like calendar to your terminal. It allows you to quickly view and edit your schedule, appointments, and tasks without leaving your command-line interface.

Built using C++ and the Ncurses library, vis offers a fast and efficient way to manage your time in the terminal. It suppors various navigation and editing commands inspired by Vim, such as navigating between days or months, adding and deleting events.

Vi Scheduler - Preview

Dependencies

The following is a list of dependencies that your system needs in order to be able to run vis.

Building & Installation

To build vis, simply clone this repository and run mkdir build; cd build; cmake ..; make

Resulting binary will be generated inside the /build/src/ folder called.

For installation, you can run sudo make install (from the /build directory)

Usage

To start vis simply run the vis binary in your terminal alongside the name of the calendar file.

For example: vis school.cal

This will open the default view mode (month) and display the current month's calendar. From there, you can use the following commands to navigate and edit the calendar:

  • h/j/k/l - Move 1 day left/down/up/right
  • u/o - Move 1 month left/right
  • g - Go to the beginning of the month
  • G - Go to the end of the month
  • i - Enter insert mode for selected day.
  • x - Delete event from selected day.
  • y - Copy event
  • p - Paste event
  • w - Write changes to file (i.e. save)
  • q - Quit and save the calendar

Todos

The following is a list of things that have been/still have to be completed.

  • Basic prototype with vipe (in memory only)
  • Finish all the basic shortcuts
  • Ability to write a calendar to a file
  • Ability to read a calendar from a file
  • Alerting function for errors and issues
  • Logging / Debug flag
  • Read input from stdin
  • Shortcut: ability to clone an event into another day

Contributions

Contributions and feedback are welcome! If you have any ideas or suggestions for improving vis, please submit a pull request or open an issue on Github. Let's make the FOSS community better, together!

License

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for more information.