Skip to content

B-Rich/tkGAME

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tkGAME

tkGAME - all-in-one Game library for Tkinter.

INTRODUCTION

tkGAME is a Python3.2+ library designed to ease up Game software development along with the Tkinter traditional GUI widgets set.

It also handles a game browser – Gabe – and aims to offer WYSIWYG game designing editors to end users.

The whole project is freefullware oriented (see below).

LICENSE

tkGAME - all-in-one Game library for Tkinter.

Copyright (c) 2014+ Raphaël SEBAN motus@laposte.net

This software is licensed under GNU GPL General Public License v3.

License terms:

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program.

If not, see http://www.gnu.org/licenses/

DEVELOPMENT STATUS

Development Status :: 3 - Alpha

Software has been:

  • Linux:

    • TESTED OK on Ubuntu;
    • should be OK with all distros;
  • macOS:

    • NOT YET TESTED;
  • MS-Windows:

Any feedback for any platform is still the welcome.

FREEFULLWARE

What is a freefullware?

A freefullware is a new kind of software:

  • Free as in Freedom;

  • Free of charge (gratis);

  • Ad-free (no advertisement at all);

  • Donate-free (no 'Donate' button at all);

  • 100% virus-free;

  • no counterpart at all;

  • really absolutely free;

Just get it and enjoy.

That's all, folks!

FEATURES

At this time, tkGAME project supports:

  • Gabe: a Game browser that eases up selecting, downloading, installing and running a certified collection of games;

  • new game: tk2048 (freefullware), a Tkinter clone of Gabriele Cirulli's famous puzzle game;

  • xxxxxxx

We plan to implement the following FUTURE supports:

  • enhancing tkGAME.lib in order to become a real Tkinter Game library for developers;

  • aiming to create WYSIWYG game editors (board, puzzle, arcade, etc);

  • xxxxxxx

DOCUMENTATION

This project has been fully documented on GitHub's wiki part:

Last known URL: https://github.com/tarball69/tkGAME/wiki

INSTALLATION

Requirements

This project has some dependencies:

  • Python language version 3.2+;

  • Python's embedded Tkinter library;

Notice: Tkinter library is mainly installed by default with Python3.

If you get ImportError concerning Tkinter, please see with help forums on how to fix it.

Installation procedure

Please, refer to our wiki documentation page for more detailed installation procedure:

https://github.com/tarball69/tkGAME/wiki/en%3Ainstall

QUICK START

Run Gabe Game browser by double-clicking on gabe.py file or launch it in a UNIX/Linux shell console:

$ python3 gabe.py

For self application development, please refer to wiki API documentation:

https://github.com/tarball69/tkGAME/wiki

BUG REPORT

In order to track bugs and fix them correctly, we'd like to hear from you.

If you encountered any problem during the use of tkGAME lib, please leave us a comment and tell us:

  • environment:

    • which platform? (Windows, macOS, Linux)
    • which Python version? (2.7+, 3.2+)
    • which tkGAME version?
    • tkinter installed correctly? (yes/no)
  • context:

    • when did it happen?
      • while trying wiki tutorial code samples?
      • while trying features on one editor especially?
      • while trying to write your own game app with tkGAME features?
  • traceback (optional):

    • are you sure IT IS a tkGAME error and not one of its additional editors?
    • could you copy/paste the console error text, please?
    • could you tell us few words about what happened?

Whatever happened, we'd like to know about it.

You will find an open issue "It did NOT work for me!" at:

https://github.com/tarball69/tkGAME/issues/1

Thank you for contributing to make tkGAME a better place for everyone.

About

tkGAME - All-in-one Game library for Tkinter

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 81.4%
  • HTML 18.5%
  • Shell 0.1%