Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jalfr3d/borrow-a-feeling-kivy-app
A small example App using python and kivy
https://github.com/jalfr3d/borrow-a-feeling-kivy-app
example-app kivy kivy-application mobile-app python python-app
Last synced: about 2 months ago
JSON representation
A small example App using python and kivy
- Host: GitHub
- URL: https://github.com/jalfr3d/borrow-a-feeling-kivy-app
- Owner: jalfr3d
- License: mit
- Created: 2023-02-27T22:38:10.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2023-11-07T20:19:45.000Z (about 1 year ago)
- Last Synced: 2024-10-15T06:41:12.986Z (3 months ago)
- Topics: example-app, kivy, kivy-application, mobile-app, python, python-app
- Language: Python
- Homepage:
- Size: 23.4 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Kivy "Borrow a Feeling" App
The "Borrow a Feeling" app is a simple and interactive mobile application built using the Kivy library. This app allows users to sign in or sign up and then choose a feeling (happy, sad, or neutral). After selecting a feeling, the app provides a corresponding inspirational or motivational quote. The app also stores user information in a `users.json` file for future logins.
## Table of Contents
- [Overview](#overview)
- [Features](#features)
- [Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Running the App](#running-the-app)
- [How to Use](#how-to-use)
- [License](#license)
## Overview
Are you feeling happy, sad, or just neutral? The "Borrow a Feeling" app is here to provide you with words of wisdom that match your emotions. Whether you need a boost of positivity or words of consolation, this app has you covered. It also allows users to sign in or sign up, so you can save your favorite quotes or share them with friends.
## Features
- User authentication with sign-in and sign-up functionality.
- Choose from three feelings: happy, sad, or neutral.
- Receive inspirational and motivational quotes based on your selected feeling.
- User account creation with the ability to log in and out.
- A dynamic quote collection with user-friendly navigation.
## Getting Started
### Prerequisites
To run the "Borrow a Feeling" app, you need to have the following prerequisites installed on your system:
- Python 3 (Python 3.7 or later is recommended).
- Kivy library.
You can install Kivy using pip:
```
pip install kivy
```
### Installation
1. Clone the repository to your local machine:
```
git clone https://github.com/jalfr3d/borrow-a-feeling-kivy-app.git
```
2. Change to the project directory:
```
cd borrow-a-feeling-kivy-app
```
### Running the App
To start the "Borrow a Feeling" app, run the following command:
```
python main.py
```
This command will launch the app, and you can interact with it using the provided user interface.
### How to Use
1. **Sign In or Sign Up**: When you launch the app, you will be greeted with a sign-in screen. You can enter your username and password to sign in. If you don't have an account, you can click the "Sign Up" button to create a new one. Remember that the email and password you provide during sign-up don't need to be real.
2. **Select a Feeling**: After signing in or signing up, you will be directed to the main screen. Here, you can choose from three feelings: happy, sad, or neutral. Click on one of the feelings to proceed.
3. **Get a Quote**: Once you've selected a feeling, the app will display an inspirational or motivational quote that matches your chosen emotion.
4. **Log Out**: If you want to log out of your account, you can click the "Log Out" button, and you will be taken back to the sign-in screen.
### License
This project is licensed under the MIT License. You are free to use and modify the code for your own purposes.