Metadata-Version: 2.4
Name: for-my-love-kuttachi
Version: 0.1.1
Summary: A cinematic, romantic terminal experience for your girlfriend.
Author-email: Your Name <your.email@example.com>
Project-URL: Homepage, https://github.com/yourusername/love-story-terminal
Project-URL: Bug Tracker, https://github.com/yourusername/love-story-terminal/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich>=13.0.0
Dynamic: license-file

# love-story-terminal

A cinematic, emotional, text-based experience for your girlfriend. This tiny love application creates an unforgettable emotional experience right in the terminal, complete with a birthday surprise.

## Installation

```sh
pip install love-story-terminal
```

## Usage

After installation, simply run:

```sh
121
```

## Features

- **Cinematic Pacing:** Uses character-by-character typewriter effects with carefully timed dramatic pauses.
- **Birthday Twist:** A beautiful transition into a happy birthday reveal complete with ASCII art.
- **Customizable:** Easily editable global variables for `GIRLFRIEND_NAME` and `CUSTOM_MESSAGE`.
- **Background Music:** Automatically plays `background_music.mp3` if placed in the same directory (or gracefully continues without it).

## Customization

1. Open `src/love_story_terminal/main.py`.
2. Change the `GIRLFRIEND_NAME` variable at the top.
3. Update `CUSTOM_MESSAGE` as desired.
4. (Optional) Provide an MP3 file named `background_music.mp3` in the current working directory from where you run the command.

## How to Publish to PyPI

If you have customized the text and want to share it publicly (so she can just `pip install` it):

1. **Install Build Tools:**
   ```sh
   pip install build twine
   ```

2. **Build the Package:**
   Navigate to the folder containing `pyproject.toml` and run:
   ```sh
   python -m build
   ```
   *This creates a `dist/` folder.*

3. **Upload to PyPI:**
   ```sh
   twine upload dist/*
   ```
   *(You will need to enter your PyPI username and password or API token).*
