photo-slideshow


Namephoto-slideshow JSON
Version 1.1.0 PyPI version JSON
download
home_page
SummarySimple tool to make a slideshow of your photos in selected directory and all the subdirectories.
upload_time2023-10-21 21:09:36
maintainer
docs_urlNone
author
requires_python
licenseMIT
keywords photo slideshow viewer presentation
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Photo SlideShow

## Overview

1. [Description](#description)
2. [Main features](#main-features-)
3. [Installation](#installation)
4. [Usage](#usage)
5. [Possible errors](#possible-errors)
5. [About](#about)

## Description

It's simple and easy tool to make a slideshow on your computer with your photos.
![photo-slideshow window](resources/photo-slideshow_window.png)

## Main features:

1. Read all photos / images from current directory and from all subdirectories
2. Possibility to choose what file types should be presented
3. Fullscreen option
4. Possibility to run the slideshow in a random order
5. It's python based so it should run everywhere where python is present

## Installation

The fastest and easiest way is to install it via `pip`. `pip` is a command line program provided with [python](https://www.python.org/downloads/).
```
pip install photo-slideshow
```
Installing from the source. Download this project. Unpack it. Go to the folder with source files. Open the main folder. Execute that command:
```
pip3 install .
```

## Usage

Run the application with command:
```
photo-slideshow
```
Application window will show up.

Browse the folder where your pictures are stored. In the settings you may configure:

- background color if the picture doesn't fit to your screen
- the time for showing current picture before switching to next one
- turn on/off random order
- select file types to be read

Select the fullscreen checkbox if you want that mode and push the start button. If you want to stop, simply push the stop button. In the fullscreen mode, push the <esc> button.

## Possible errors
If you get error:
```
ModuleNotFoundError: No module named 'tkinter'
```
It tells that you have to install pythong GUI framework (Tcl/Tk). Depends on the operating systems the instruction may differ, for example:
1. In windows open `python installer -> modify -> select tcl/tk and IDLE`, go next and finalize installation.
2. Ubuntu / debian: `sudo apt-get install python3-tk`
3. Fedora: `sudo dnf install python3-tkinter`
4. CentOS: `sudo yum install python3-tkinter`
5. MacOS: `brew install python-tk@3.10`
6. For other, just check hot to install.

When tkinter is installed you can run photo-slideshow.

## License

MIT License.

## About
Author: Mateusz Poślednik. Experienced data engineer, but also photographer. I was missing an easy, light software to make a slideshow on my photos. Most of the applications can make the slideshow only for current directory, but my photos are organized in many subdirectories.

My other projects: [https://github.com/matipos](https://github.com/matipos) and [https://github.com/matipos2](https://github.com/matipos2)

Contact: [https://matpos.pythonanywhere.com/](https://matpos.pythonanywhere.com/)

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "photo-slideshow",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "photo,slideshow,viewer,presentation",
    "author": "",
    "author_email": "Mateusz Po\u015blednik <matipos002@yahoo.com>",
    "download_url": "https://files.pythonhosted.org/packages/03/38/ed0ee75be696e9fdc42bce4d2c03a2208cd366fdc568c4050a05edb8d4e0/photo-slideshow-1.1.0.tar.gz",
    "platform": null,
    "description": "# Photo SlideShow\n\n## Overview\n\n1. [Description](#description)\n2. [Main features](#main-features-)\n3. [Installation](#installation)\n4. [Usage](#usage)\n5. [Possible errors](#possible-errors)\n5. [About](#about)\n\n## Description\n\nIt's simple and easy tool to make a slideshow on your computer with your photos.\n![photo-slideshow window](resources/photo-slideshow_window.png)\n\n## Main features:\n\n1. Read all photos / images from current directory and from all subdirectories\n2. Possibility to choose what file types should be presented\n3. Fullscreen option\n4. Possibility to run the slideshow in a random order\n5. It's python based so it should run everywhere where python is present\n\n## Installation\n\nThe fastest and easiest way is to install it via `pip`. `pip` is a command line program provided with [python](https://www.python.org/downloads/).\n```\npip install photo-slideshow\n```\nInstalling from the source. Download this project. Unpack it. Go to the folder with source files. Open the main folder. Execute that command:\n```\npip3 install .\n```\n\n## Usage\n\nRun the application with command:\n```\nphoto-slideshow\n```\nApplication window will show up.\n\nBrowse the folder where your pictures are stored. In the settings you may configure:\n\n- background color if the picture doesn't fit to your screen\n- the time for showing current picture before switching to next one\n- turn on/off random order\n- select file types to be read\n\nSelect the fullscreen checkbox if you want that mode and push the start button. If you want to stop, simply push the stop button. In the fullscreen mode, push the <esc> button.\n\n## Possible errors\nIf you get error:\n```\nModuleNotFoundError: No module named 'tkinter'\n```\nIt tells that you have to install pythong GUI framework (Tcl/Tk). Depends on the operating systems the instruction may differ, for example:\n1. In windows open `python installer -> modify -> select tcl/tk and IDLE`, go next and finalize installation.\n2. Ubuntu / debian: `sudo apt-get install python3-tk`\n3. Fedora: `sudo dnf install python3-tkinter`\n4. CentOS: `sudo yum install python3-tkinter`\n5. MacOS: `brew install python-tk@3.10`\n6. For other, just check hot to install.\n\nWhen tkinter is installed you can run photo-slideshow.\n\n## License\n\nMIT License.\n\n## About\nAuthor: Mateusz Po\u015blednik. Experienced data engineer, but also photographer. I was missing an easy, light software to make a slideshow on my photos. Most of the applications can make the slideshow only for current directory, but my photos are organized in many subdirectories.\n\nMy other projects: [https://github.com/matipos](https://github.com/matipos) and [https://github.com/matipos2](https://github.com/matipos2)\n\nContact: [https://matpos.pythonanywhere.com/](https://matpos.pythonanywhere.com/)\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Simple tool to make a slideshow of your photos in selected directory and all the subdirectories.",
    "version": "1.1.0",
    "project_urls": {
        "homepage": "https://github.com/matipos2/photo-slideshow",
        "repository": "https://github.com/matipos2/photo-slideshow"
    },
    "split_keywords": [
        "photo",
        "slideshow",
        "viewer",
        "presentation"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f9dec01dfa67e6ff30b18755b322391523a4ca1daca467a248ddbb9a7b9af80c",
                "md5": "19fca8a7fd9907c903000a2b609c5c79",
                "sha256": "0577f337e2ff59d7766b85d64959a1346cc7d30425e673b41158955fc14317f4"
            },
            "downloads": -1,
            "filename": "photo_slideshow-1.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "19fca8a7fd9907c903000a2b609c5c79",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 175104,
            "upload_time": "2023-10-21T21:09:33",
            "upload_time_iso_8601": "2023-10-21T21:09:33.942809Z",
            "url": "https://files.pythonhosted.org/packages/f9/de/c01dfa67e6ff30b18755b322391523a4ca1daca467a248ddbb9a7b9af80c/photo_slideshow-1.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "0338ed0ee75be696e9fdc42bce4d2c03a2208cd366fdc568c4050a05edb8d4e0",
                "md5": "0b490f26eba17f96f55fbb512b0e6ffb",
                "sha256": "8584ab9664e9bcbecace0779cb782c229b95d5eb0349c5c6e27b9cdf37dc8071"
            },
            "downloads": -1,
            "filename": "photo-slideshow-1.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "0b490f26eba17f96f55fbb512b0e6ffb",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 173410,
            "upload_time": "2023-10-21T21:09:36",
            "upload_time_iso_8601": "2023-10-21T21:09:36.601750Z",
            "url": "https://files.pythonhosted.org/packages/03/38/ed0ee75be696e9fdc42bce4d2c03a2208cd366fdc568c4050a05edb8d4e0/photo-slideshow-1.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-10-21 21:09:36",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "matipos2",
    "github_project": "photo-slideshow",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [],
    "lcname": "photo-slideshow"
}
        
Elapsed time: 0.12807s