📚 m223rx – libraryX Book Management System

---

🚀 Features

• Book Inventory Management
  Add, update, delete, and track books with details like title, author, ISBN, year, and status.

• Borrower Tracking
  Assign books to borrowers and track who currently has a copy.

• CSV Import & Export
  Load and save your book database easily using CSV files.

• Search & Filter
  Quickly find books by title, author, ISBN, or status.

• Table View Display
  Displays books in a clean, tabular format for easy reading.

• Persistent Local Storage
  Books and borrower data are stored locally in CSV for offline usage.

• User-Friendly Interface
  Simple and intuitive CLI/terminal interface for smooth interaction.

---

🛠 Tech Stack

• Languages:

  • Python – core logic and data management

• Libraries:

  • python-dotenv – environment variable management
  • csv – reading and writing book data

• Deployment:

  • Runs locally on any system with Python 3.x installed
  • No external server required

---

⚡ Usage

1. Clone the repository:

   git clone https://github.com/m223rx/libraryX.git
   cd libraryX
   

2. Install dependencies

   pip install -r requirements.txt
   

3. Set environment variables

• Create a .env file:

  FILE_NAME=data/books.csv
  

4. Run the application

python main.py

5. Manage your library
   • Add, view, update, or delete books
   • Track borrowers and book statuses

---

🎨 Customization

• Change the default CSV path in .env.
• Modify table display formatting in libs/storage.py.
• Add new fields or borrower management logic in models/models.py.
• Customize CLI prompts in main.py.

---

💡 Future Enhancements

• Add a graphical interface with Tkinter or PyQt.
• Enable automatic CSV backups.
• Implement advanced search and sorting.
• Track borrowing history and due dates.
• Add multi-user support with separate libraries.

---

v2 Exclusive – GUI Features

• Graphical User Interface (GUI) – Tkinter-based interface for smooth interaction.

• Interactive Buttons & Forms – Perform all operations with clicks.

• Splash Screen & Credits – Branded splash screen on launch.

• Statistics Dashboard – View total, borrowed, and available books.

• Modern Layout – Organized windows and menus for intuitive navigation.

👨‍💻 Developer

m223rx – 2025

© 2025 m223rx. All rights reserved.