Skip to content

Tired of manually creating folder structures for your film projects? Want a folder structure that dynamically changes based on the needs for your current project? Then init-film was made for you! By filmmakers, for filmmakers ;)

License

Notifications You must be signed in to change notification settings

andreasdelabie/init-film

Repository files navigation

Init-Film

image
Tired of manually creating folder structures for your film/video projects?
Want a folder structure that dynamically changes based on the needs for your project?
Then Init-Film was made for you!
By filmmakers, for filmmakers ;)

Key features:

  • ♥️ Supports Windows, Linux, and macOS
  • ✅ Dynamically create folder structures by selecting options from a list
  • 🖋️ Use custom folder names
  • 📝 Import file templates & project assets to reuse across multiple projects
  • ✨ Customize the prefix style to your preference!
  • 🖱️ Start a new project by right-clicking in a folder and selecting "Start Init-Film Project" (Windows only)

Before installing:

Make sure you have any of the following Python versions installed (tested with tox):

Installation:

Method 1 (from PyPi):

Watch YouTube tutorial
Use pip install init-film to install the latest version of init-film.

Method 2 (from source):

Watch YouTube tutorial

  1. Download the repo by using git clone https://github.com/andreasdelabie/init-film or download the zip folder from the releases.
  2. Navigate to the folder by using cd [path to folder] or using a file explorer.
  3. Use pip install . to install the script.

Error: externally-managed-environment

image
Check out the documentation for externally managed environments.

Usage:

Watch showcase

Basic usage:

Use the CLI command init-film in any folder to start a new film/video project.

Custom folder names:

Folder names can't contain spaces (with the exception of the project name). Instead use a - or _.

Configuration:

  • Use init-film --set-number-style <style> to set the number style to default (1. PROJECT FILES) or double (01. PROJECT FILES).
  • Use init-film --set-separator-style <style> to set the separator style to dot (default), underscore, parenthesis, or space.
  • Use init-film --set-templates-path to set the template path to python (.../site-packages/initfilm/templates) or a custom path (ex. C:/Users/Spielberg/Videos/templates). Make sure to ALWAYS USE FORWARD SLASHES!
  • Use init-film --show-config to print the current configuration and the path to the config.json file.

Templates:

Put your template files in the relative template folders (use init-film --show-templates-path to show the location).
Init-Film will automatically detect them and let you select them when creating a new project.

Example:

If I use the following folder structure:

1. PROJECT FILES
  1. PREMIERE PRO
  2. AFTER EFFECTS
2. ASSETS
  1. LOGOS
  2. GRAPHICS
3. FOOTAGE
4. AUDIO
  1. SFX
  2. MUSIC
5. EXPORT
6. CUSTOM-FOLDER

I put the template files in the templates folder like this:

PROJECT FILES
  PREMIERE PRO
    YouTube_Video_Preset.prproj
  AFTER EFFECTS
    Animation_Preset.aep
ASSETS
  LOGOS
    Logo1.png
    Logo2.jpg
  GRAPHICS
    Explosion.mov
    Title.ai
AUDIO
  SFX
    Explosion.wav
    Whoosh.mp3
  MUSIC
    Theme_Song.wav
    Outro_Song.wav
CUSTOM-FOLDER
  Custom_Folder_Template_File.docx

Add shortcut to Windows context menu (right click menu):

  • Use init-film --add-shortcut to add Init-Film to your Windows context menu.
  • Use init-film --remove-shortcut to remove it.

Help:

Use init-film --help or init-film -h to show the help screen.

Updating:

Use pip install --upgrade init-film to update to the latest version of init-film.

Uninstalling:

Use pip uninstall init-film to fully uninstall init-film from your system.

Support:

About

Tired of manually creating folder structures for your film projects? Want a folder structure that dynamically changes based on the needs for your current project? Then init-film was made for you! By filmmakers, for filmmakers ;)

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Languages