Skip to content

astigPree/OCTour

Repository files navigation

OC TOUR 📱

Interactive Mobile Tour for the Osmena Colleges Computer Science Department

Python Kivy KivyMD Platform Development Status


📌 Introduction

OC TOUR is a mobile application designed to showcase the Computer Science Department of Osmena Colleges in an engaging and interactive way.

The application simulates a virtual department tour, where users explore different floors and rooms of the department while being guided by a randomly generated tour guide character. The navigation system is designed to feel game-like, encouraging users to explore the department while learning about each room and its purpose.

This project demonstrates how Python can be used to build Android mobile applications using the Kivy framework while implementing interactive UI design and user-friendly navigation.


🛠 Technologies Used

The project was built using the following technologies:

Technology Purpose
Python Main programming language
Kivy Cross-platform framework for building mobile apps
KivyMD Material Design components for Kivy
Python-for-Android Converts Python applications into Android APK
Kivy-iOS Cross-platform compatibility
Linux Development environment
Google Colab Testing and experimentation

⚙️ Development Process (How I Built It)

1. Concept Planning

The idea started as a way to introduce the Computer Science department through an interactive and engaging digital experience instead of a traditional presentation.

2. UI/UX Design

Using Kivy and KivyMD, I designed a clean interface that allows users to navigate through different floors of the department easily.

3. Virtual Guide Feature

A random guide character system was implemented to simulate the feeling of interacting with a real tour guide.

4. Navigation System

The application uses multiple screens to represent floors and rooms, allowing users to move through the department like navigating a small game.

5. Testing and Debugging

The application was tested in a Linux development environment and later compiled to run on Android devices.

6. Android Packaging

The project was packaged into an Android APK using python-for-android tools.


📚 What I Learned

During the development of this project, I learned:

  • How to build mobile applications using Python
  • Using the Kivy framework for cross-platform development
  • Designing interactive user interfaces
  • Managing multi-screen navigation systems
  • Packaging Python projects into Android applications
  • Debugging mobile UI and performance issues

📈 Overall Growth

This project helped me improve my skills in:

  • Mobile application development
  • UI/UX design
  • Python application architecture
  • Cross-platform development
  • Problem-solving and debugging

It also strengthened my ability to transform an idea into a complete working application, including development, testing, and deployment.


🔮 Possible Improvements

Future improvements for the project may include:

  • Adding 3D floor maps
  • Implementing voice narration for the virtual guide
  • Improving animations and transitions
  • Adding interactive department maps
  • Expanding the system to support other departments
  • Adding dynamic data using a database

🚀 Running the Project

1️⃣ Clone the Repository

git clone https://github.com/yourusername/oc-tour.git
cd oc-tour

2️⃣ Install Dependencies

pip install kivy kivymd

3️⃣ Run the Application

python main.py

4️⃣ Build Android APK (Optional)

buildozer android debug

🖼 Screenshots

Image 1 Image 2 Image 3

📄 License

This project was developed for educational purposes.

About

An interactive Android mobile tour application built with Python and Kivy that showcases the Computer Science Department of Osmena Colleges through a gamified floor navigation experience.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors