tkScenarist - screenwriting made simpler

Getting started

Summary

Downloading the application

Official release versions

It is highly recommended for users to download ONLY official release versions of tkScenarist software application.

Official release versions stay at GitHub's Releases web page and are sorted from most recent to oldest.

Click on zip link (MS-Windows™ users, recommended) or tar.gz link (UNIX/Linux users, optional) to download a compressed archive of the release, then unzip the archive with your favourite tool.

Copy the tkScenarist subfolder you may find into the unzipped main folder you obtained to a safe directory location e.g. let's say into some private apps folder.

Your software is now ready for trying out!

Return to summary.

Daily build

Some explorers may wish to go further and get the latest unofficial release versions with the most experimental features of tkScenarist.

To do this, simply click on the Download ZIP button you may find on the right-hand side of GitHub project's main page.

CAUTION: unofficial daily build versions are NOT guaranteed to work in any manner.

You play with these at your own risks.

Return to summary.

Forks and pull requests

People willing to improve files from the project are suggested to study GitHub's official documentation about forks and pull requests.

Thank you for trying to help us.

Return to summary.

Installing tkScenarist

General purpose

This program does NOT need to be installed in any way.

Simply download it, unzip it (into an apps private directory, for example) and use it right now.

Return to summary.

Pre-requisites

This software runs only with Python3 (Python >= 3.3) and Tkinter (Tcl/Tk >= 8.5) installed on your machine.

No dependencies, no third-part lib to install on more.

If you have a recent Python3 programming language correctly installed, Tkinter library should also be installed by default as a Python standard lib.

Any ImportError will either mean you are trying to launch the software with Python2 or you don't have Tkinter library correctly installed on your system.

Installing a Python3 version of the language does not alter an already installed Python2 version in any way.

You may consider installing Python3 from:

https://www.python.org/downloads/ (Ctrl+click: open in new tab)

Return to summary.

UNIX/Linux

Many major Linux distributions (e.g. Ubuntu, SuSE, etc) do already have a pre-installed Python3/Tkinter bundle.

In this particular case, you should NOT consider to make any special installation by yourself.

Simply download and use this program as is.

Return to summary.

MS-Windows™

Many MS-Windows™ users wonder why do they have a shell console window coming up with the application on startup.

This is a quite normal Python default behaviour.

If you wish to use a Python application without its dedicated shell console window, simply rename file extension from .py to .pyw and then launch it again.

For the present case, this means you should rename tkscenarist.py to tkscenarist.pyw and then run it once again.

Return to summary.

Bug report

Anyway and whatever happens, please report troubleshootings by posting a short message on GitHub's bugtracker.

You may also request for help on our mailing list:

https://mail.python.org/mailman/listinfo/tkscenarist-help

Thank you to help us improving tkScenarist for the benefit of all.

Return to summary.

First steps

Launching app

Into MS-Windows™

Simply double-click on tkscenarist.py file to launch app.

You may find this file into the tkScenarist project subfolder.

Notice : if you chose to get rid of console app, you should double-click on tkscenarist.pyw file instead of the genuine tkscenarist.py file.

Return to summary.

Into UNIX/Linux

Click on tkscenarist.py file if it has the 'executable' sticky bit on or open a shell console and launch file:

    $ cd go/to/the/right/place # e.g. tkScenarist folder
    $ python3 tkscenarist.py

You may find this file into the tkScenarist project subfolder.

Return to summary.

The 'executable' sticky bit

To set the 'executable' sticky bit on, simply do a:

    $ cd go/to/the/right/place # e.g. tkScenarist folder
    $ chmod +x tkscenarist.py

Since then, it will be possible to simply (double) click on tkscenarist.py file into your favourite file manager and to launch tkScenarist app visually.

Return to summary.

How does it work?

tkScenarist application software works with tabs allowing writers to get all essentials in a single hand.

Tabs are ordered along with some natural and/or intuitive way:

  1. finding a project's title;
  2. adding some subtitle and episode number/title (optional);
  3. writing personal notes on a draft, to help shaping the story;
  4. writing the strongest steps of the story into a pitch/concept text zone;
  5. managing movie characters, with their own history logs and relationships;
  6. finally, writing the scenario itself;
  7. storyboard is an extra tool for small projects aiming to keep all in one hand;
  8. same thing for resources.

On top of this, one may find useful tools, such as:

  • a name database, where you can search amongst thousands of names coming from all origins over the planet;
  • story/pitch templates manager: pick up templates from other people or write your own (you could share with the world);
  • a scenario elements editor (SEE) made for finer scenario script tuning and fancier look'n'feel.

Please, note playing with the SEE look'n'feel features would NOT impact PDF exportations in any way, as printable PDF documents follow strict policies for their look'n'feel, in order to match professional submission.

Return to summary.

Going further

People willing to learn much more about tkScenarist software application are suggested to dive into the whole online documentation available on GitHub's wiki pages.

Return to summary.


Quick nav

Return to homepage.