Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ticky/lnshot
🧖🏻♀️ Symlink your Steam screenshots to a sensible place
https://github.com/ticky/lnshot
daemon screenshot-utility screenshots steam steam-deck symlink symlinks symlinks-manager systemd utility
Last synced: 5 days ago
JSON representation
🧖🏻♀️ Symlink your Steam screenshots to a sensible place
- Host: GitHub
- URL: https://github.com/ticky/lnshot
- Owner: ticky
- License: apache-2.0
- Created: 2022-10-21T06:26:31.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-01T01:13:42.000Z (about 1 month ago)
- Last Synced: 2024-10-03T12:39:41.335Z (about 1 month ago)
- Topics: daemon, screenshot-utility, screenshots, steam, steam-deck, symlink, symlinks, symlinks-manager, systemd, utility
- Language: Rust
- Homepage:
- Size: 161 KB
- Stars: 35
- Watchers: 3
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE-APACHE.txt
Awesome Lists containing this project
README
# `lnshot`
[](https://github.com/ticky/lnshot/actions/workflows/rust.yml)
🧖🏻♀️ Symlink your Steam games' screenshot directories into your Pictures folder
## About
This is a little utility to work around a bugbear of mine with the Steam client. Steam provides a pretty handy in-game screenshot tool, but the screenshots are stored deep in Steam's own folder hierarchy, despite lacking any cloud sync function other than uploading them manually.
Running `lnshot` will generate a set of [symbolic links](https://en.wikipedia.org/wiki/Symbolic_link) (basically, folders which are shortcuts) for each game's screenshot directory within your normal Pictures folder. This means you get this:
```
📂 ~/Pictures/Steam Screenshots
└ 📂 Ticky
├ 📂 Hardspace Shipbreaker
│ └ 🌌 20221020102933_1.jpg
├ 📂 Need for Speed: Most Wanted
│ └ 🌃 20221005164632_1.jpg
└ 📂 The Big Con
└ 🏞 20221005164632_1.jpg
```
Instead of this:
```
📂 ~/.local/share/Steam/userdata
└ 📂 69420691
└ 📂 760
└ 📂 remote
├ 📂 1139280
│ └ 📂 screenshots
│ └ 🏞 20221005164632_1.jpg
├ 📂 1161580
│ └ 📂 screenshots
│ └ 🌌 20221020102933_1.jpg
└ 📂 6547380
└ 📂 screenshots
└ 🌃 20221005164632_1.jpg
```
`lnshot` can detect Steam's installation directory, and automatically find your Pictures folder across all three supported Steam platforms.
User folders are generated for each Steam user logged into your system (filtering is not yet supported). Game folders will be named after your game title for non-Steam shortcuts, and named the same as the `steamapps/common` installation folder for games managed by Steam, which is usually a reasonable name. This may change to use the full Steam app name in the future.
`lnshot` does this offline, using only the metadata Steam already has stored on your hard disk.
## Installation
Builds are not currently provided, so it's currently expected that you know your way around the Rust compiler.
Clone this repository and run `cargo install --path .` inside it.
## Usage
Run `lnshot` to automatically symlink to `Steam Screenshots` within your Pictures folder.
`lnshot --help` provides information about other options, including using a different name for the `Steam Screenshots` folder.
### Automation
`lnshot` provides a "daemon" mode, allowing for monitoring the file system for changes in the Steam screenshot folders.
#### Linux (Steam Deck)
On Steam Deck, we can take advantage of `systemd` to run `lnshot` automatically.
1. Run `mkdir -p ~/.config/systemd/user` to create the folder we need
2. Create `~/.config/systemd/user/lnshot.service` (easy mode: `nano ~/.config/systemd/user/lnshot.service`), and paste this into it:
```ini
[Unit]
Description=Steam Screenshot Symlinking Service
[Service]
ExecStart=%h/.cargo/bin/lnshot daemon
Restart=always
[Install]
WantedBy=default.target
```
3. Save the file
4. Run `systemctl enable --user lnshot.service` to make it automatically start in the future.