[Playlist Cleaner](https://codoplayer.com/tools/cleaner)

# IPTV Playlist Cleaner

Removes duplicate channels and clears the clutter out of names — “|UK| NEWS ONE FHD ★” becomes “News One” — with a preview on your own channels before anything is written.

## How it works

1. Load your playlist.
2. Choose what to clean and watch the preview on your own channel names.
3. Download the cleaned playlist and see how much was removed.

## What the results mean

The preview shows what will change: repeated entries removed and names tidied, such as country prefixes, HD tags, symbols and ALL CAPS. The file keeps your links and guide IDs.

## Common problems

Tidying names can make two different channels look alike, so check the preview before downloading. If a channel loses its programme guide after a rename, run the EPG Matcher.

## Example result

Produced by this tool's own code from a small invented example. Prefixes such as "UK:", quality tags and brackets are removed from the names, and the repeated address is dropped.

**Example input** (invented, example.com addresses):

```
#EXTM3U x-tvg-url="http://example.com/guide.xml"
#EXTINF:-1 tvg-id="news.one" tvg-logo="http://example.com/logos/news-one.png" group-title="News",UK: News One HD
http://example.com/live/user/pass/1001.m3u8
#EXTINF:-1 tvg-id="Sports.Two" group-title="Sports",Sports Two [FHD]
http://example.com/live/user/pass/1002.m3u8
#EXTINF:-1 group-title="Kids",Kids Three
http://example.com/live/user/pass/1003.m3u8
#EXTINF:-1 group-title="News",News One
http://example.com/live/user/pass/1001.m3u8
#EXTINF:-1 tvg-id="film.nine" group-title="Movies",Example Film (2020)
http://example.com/movie/user/pass/2001.mp4
#EXTINF:-1 group-title="Music",Music Four
http://example.com/live/user/pass/1004.m3u8
#EXTINF:-1 group-title="Music",
not-a-link
```

**Result**

```
#EXTM3U url-tvg="http://example.com/guide.xml"
#EXTINF:-1 tvg-id="news.one" tvg-logo="http://example.com/logos/news-one.png" group-title="News",News One
http://example.com/live/user/pass/1001.m3u8
#EXTINF:-1 tvg-id="Sports.Two" group-title="Sports",Sports Two
http://example.com/live/user/pass/1002.m3u8
#EXTINF:-1 group-title="Kids",Kids Three
http://example.com/live/user/pass/1003.m3u8
#EXTINF:-1 group-title="Music",Music Four
http://example.com/live/user/pass/1004.m3u8

In: 7 entries, written: 4, duplicates removed: 1, left out by the type choice: 2
```

## Messages this tool can show

| Message | What it means | What to do |
| --- | --- | --- |
| Paste the playlist link. | The playlist field was empty. | Paste the link, or choose an Xtream login or a file. |
| The link must start with http:// or https:// | The address is not a web link. | Copy the whole link from your provider, including the first part. |
| That server address isn’t right — it looks like http://example.tv:8080 | The Xtream server address could not be read. | Type the address with its port, as your provider gave it. |
| The provider says this username or password is wrong, or the line has been cancelled. | The provider refused the login. | Check the details with your provider; the line may have expired. |
| That server didn’t answer like an Xtream panel — check the server address (and its port) with your provider. | The address answered, but not as an Xtream server. | Ask your provider for the right address and port. |
| This provider has been refusing our server, so we’re giving it a break — try again in N minutes. | The provider keeps refusing requests, so the tool stops asking for a while. | Wait, and do not keep retrying. The provider may block some networks. |
| That file isn’t a playlist we can read. | The file is not M3U, M3U8, Enigma2, Neutrino WebTV, XSPF, PLS or WPL. | Check that you chose the playlist file. |
| This playlist has more than the most entries our tools read. | The playlist is too large for the tools. | Use a smaller list, for example live channels only. |
| This playlist is no longer loaded on our server (we keep a loaded playlist for 4 hours) — load it again. | The loaded copy has expired. | Load the playlist again. |

## Questions about the Playlist Cleaner

### Which duplicate is kept?

The first one in the playlist. “Same link” drops exact copies; “same name in the same group” also drops the backup copies some providers add.

### Does cleaning names break the TV guide?

No — the guide finds channels by their tvg-id, which isn’t changed.

## More playlist tools

- [Playlist Editor](https://codoplayer.com/tools/editor): Choose, rename and reorder groups and channels, then download your own playlist.
- [M3U Validator](https://codoplayer.com/tools/validator): Find broken lines, bad links, duplicates and missing guide IDs, then download a fixed file.
- [Size Optimizer](https://codoplayer.com/tools/optimizer): Shrink a huge playlist so old TVs and boxes can open it.
- [Country Filter](https://codoplayer.com/tools/filter): Keep only the countries and languages you watch.
- [Category Organizer](https://codoplayer.com/tools/organizer): Sort channels into Sports, News, Kids, Films… or remove a whole category.
- [Logo Finder](https://codoplayer.com/tools/logos): Fill in missing channel logos from your TV guide.

### Related

- [IPTV guide shows "No information": fix tvg-id mismatches](https://codoplayer.com/guides/epg-no-information)

Source: https://codoplayer.com/tools/cleaner
