Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A Java GUI utility to rename TV episodes from TV listings
Java

README.md

TVRenamer

Build Status

About

TVRenamer is a Java GUI utility to rename TV episodes from TV listings
Basically, it will take an ugly filename like Lost.S06E05.DD51.720p.WEB-DL.AVC-FUSiON.mkv and rename it to Lost [6x05] Lighthouse.mkv

Features

  • Rename many different shows at once
  • Customise the format and content of the resulting filename
  • Native look & feel for your operating system
  • Drag & Drop or standard 'add file' interface

Usage & Download

Download the correct version for your operating system (OSX, Windows, Linux) and architecture (32 or 64 bit)

  • On Windows:
    1. Unzip the downloaded file somewhere, possibly your Desktop or C:\Program Files
    2. Double click the .exe file
  • On OSX:
    1. Unzip the downloaded file somewhere, possibly your Desktop or /Applications
    2. Double click the .app file
  • On Linux:
    1. Unzip the downloaded file somewhere, possibly your Desktop
    2. It is easiest to add TVRenamer to the top Gnome bar (no need for the terminal). Add a 'Custom Application Launcher' with the below settings:
      Type: Application
      Name: TVRenamer
      Command: /TVRenamer-<version>/run-linux.sh
      Icon: Can be anything, perhaps our icon
      If the application doesn't start, or if you have problems switch the Type to be 'Application in Terminal'
    3. If you don't add it to the Gnome bar, open an terminal and cd to where you unzipped the file to. Then cd into the TVRenamer-<version> folder. There should be run-linux.sh and tvrenamer.jar file there.
    4. Execute the run script via ./run-linux.sh

Common Problems

Java version issues

Ensure that you have Java version 5 or 6 installed. Type java -version into your terminal and ensure that the output is similar to:

java version "1.6.0_14"
Java(TM) SE Runtime Environment (build 1.6.0_14-b08)
Java HotSpot(TM) 64-Bit Server VM (build 14.0-b16, mixed mode)

TVRenamer version issues

Ensure that you are running the correct version of TVRenamer for the version of Java you are running. If you don't have it right, you get a helpful error message on startup (when running on the terminal), like below:
Exception in thread "main" java.lang.UnsatisfiedLinkError: Cannot load 32-bit SWT libraries on 64-bit JVM To fix this, see the output of java -version, the last line will say if you are running 64-bit Java or not. Then download the appropriate version.

"TVRenamer can't be opened because it's from an unidentified developer" error message on Mountain Lion

This is because we have not signed the application with Apple (and because we use Java, they won't allow us to). To get around this, just right-click the app in Finder and select Open. You only need to do this once.
More information from iMore

Getting Support and Submitting Bug Reports

View past bug reports and if that is no help then submit a new one, but please add labels appropriately. The developers will be notified and you should hear back shortly.

Running in debug mode

If the application crashes it helps us greatly if you can provide us a stacktrace of what went wrong. In order to do this, you just need to run the application in the terminal, then copy the output into a new bug report.

If the application doesn't start with a java error, ensure that your JAVA_HOME environment variable is set correctly.

  • On Windows:
    1. Open the Windows Command Prompt (Windows key + r, then type cmd and push enter)
    2. Navigate to where the TVRenamer application is.
    3. Execute java -jar TVRenamer-<version>.exe
  • On OSX:
    1. Open the Terminal application (at /Applications/Utilities/Terminal.app)
    2. Navigate to where the TVRenamer application is.
    3. Execute it via ./TVRenamer-<version>.app
  • On Linux:
    1. Open the Terminal application (from the Gnome Applications menu)
    2. Navigate to where the TVRenamer application is.
    3. Execute the run script via ./TVRenamer-<version>.app/Contents/MacOS/run-mac.sh

Contributions

The development team numbers just 2, so anything from Java code patches to UI/UX recommendations would be gratefully received.
To contribute to the code side of things you should know Java and it would be helpful if you know some SWT and git. The easiest way to submit changes is via a guthub pull request based off the devel branch.
If you anything else (feature requests, comments, fanmail!), create a new issue and set the label to be 'Type-Enhancement'.

Something went wrong with that request. Please try again.